Examples of javax.microedition.content.Registry.register()

• javax.microedition.content.Registry.register()
  Registers the application class using content type(s), suffix(es), and action(s), action name(s), access restrictions and content handler ID.

  This method will replace any content handler registration in the application package that has the same classname. The update occurs atomically: the update to the registry either occurs or it does not.

  The content handler may register the following items:

  • zero or more content types
  • zero or more suffixes
  • zero or more actions
  • zero or more mappings from actions to action names
  • zero or more IDs of applications allowed access
  • an optional application ID

  If no exceptions are thrown, then the type(s), suffix(s), action(s), action names, access restrictions, and ID will be registered for the application class.

  If an exception is thrown, then the previous registration, if any, will not be removed or modified. @param classname the name of an application class orcontent handler in this application package; the value MUST NOT be null; and the handler MUST implement the lifecycle of the Java runtime environment @param types an array of types to register;if null it is treated the same as an empty array @param suffixes an array of suffixes to register;if null it is treated the same as an empty array @param actions an array of actions to register;if null it is treated the same as an empty array @param actionnames an array of ActionNameMaps to register;if null it is treated the same as an empty array @param ID the content handler ID; if nulla default non-null value MUST be provided by the implementation @param accessAllowed the IDs of applications and contenthandlers that are allowed visibility and access to this content handler; if null or an empty array then all applications and content handlers are allowed access; otherwise ONLY applications and content handlers with matching IDs are allowed access. @return the registered ContentHandler; MUST NOT be null @exception NullPointerException if any of the following items isnull:

  • classname
  • any array element of types, suffixes, actions, actionnames, and accessAllowed

  @exception IllegalArgumentException is thrown:

  • if any of the types, suffix, actions, or accessAllowed strings have a length of zero, or
  • if the classname does not implement the valid lifecycle for the Java runtime environment,
  • if the ID has a length of zero or contains any control character or space (U+0000-U+00020),
  • if the sequence of actions in any ActionNameMap is not the same as the sequence of actions, or
  • if the locales of the ActionNameMaps are not unique.

  @exception ClassNotFoundException if the classnameis not present @exception ContentHandlerException with an error code of {@link ContentHandlerException#AMBIGUOUS} if ID(or if ID is null, the default ID) is a prefix of any registered handler or if any registered handler ID is a prefix of this ID, except where the registration is replacing or updating an existing registration with the same classname @exception SecurityException if registrationis not permitted