Examples of javax.microedition.content.Invocation

javax.microedition.content.Invocation
An Invocation contains the parameters that are passed from an invoking application to a content handler and the results that are returned to the application. The parameters are the type, URL, action, content handler ID, and responseRequired. The string and data arguments can be set using {@link #setArgs setArgs} and {@link #setData setData} methods.All of the parameters are provided to the content handler and are returned with the handlers response, if any. Invocation instances are not thread safe, the application must handle any synchronization necessary.

The values of content handler ID, type, URL, and action are used to identify the content handler when invoked by {@link Registry#invoke Registry.invoke}. If an Invocation contains an ID then it is used to identify the content handler to be invoked. The other parameters are input to the content handler.
If a type is present, it is used to find handlers that support that type. The application should supply the type if it is known. If the type is not set, then calling the {@link #findType findType} will find the type using the URL to thecontent.
Invocation Status

The status value indicates the next processing step of the invocation by the content handler. The status of an Invocation can be any of the following:
- {@link #INIT}—indicates the Invocation is still being initialized
- {@link #WAITING}—indicates that this Invocation is waiting to complete
- {@link #ACTIVE}—indicates the Invocation is currently being processed
- {@link #HOLD}—indicates the Invocation is currently waiting for a chained Invocation to complete
- {@link #ERROR}, {@link #OK}, {@link #CANCELLED}— indicate that the Invocation is complete
- {@link #INITIATED}— indicate that the Invocation has been initiated but the content handler cannot provide a response when it is finished.
All status transitions occur only during method calls that involve the Invocation instance. The transitions that occur are specified in the methods that make the change visible. For example, when an invoking application creates a new Invocation, the status is {@link #INIT INIT}. When the application calls {@link Registry#invoke Registry.invoke}the status changes to {@link #WAITING WAITING}. When the Registry.getResponse method is invoked, the status will be updated to the appropriate {@link #OK OK}, {@link #CANCELLED CANCELLED}, {@link #INITIATED INITIATED}, or {@link #ERROR ERROR} status from the content handler.
A content handler calls {@link ContentHandlerServer#getRequest ContentHandlerServer.getRequest}to get the next request. The request always has the {@link #ACTIVE ACTIVE} status.When the handler is finished acting on the content, the status is set to either {@link #OK OK}, {@link #CANCELLED CANCELLED}, or {@link #INITIATED INITIATED} bythe {@link ContentHandlerServer#finish ContentHandlerServer.finish} method.
If the handler is chaining, then the new Invocation follows the status transitions of invoke as described above. The status of the previous invocation being chained from is set to {@link #HOLD HOLD}by the Registry.invoke method. The status of the previous Invocation is restored to {@link #ACTIVE ACTIVE} by the{@link Registry#getResponse Registry.getResponse}method that returns the status for the new Invocation.
If the content handler application causes faults because it does not properly dequeue and respond to invocations as described in the {@link ContentHandler} class, then thestatus is set to {@link #ERROR ERROR} in the response queued backto the invoking application.
Access to Content

The implementation of the invocation mechanism may save or cache information about the request, the URL, the content type, or content during the invocation. The information may be utilized when the application accesses the content with the {@link #open open} method.The {@link #getURL} method MUST return the original URL unmodifiedby any implementation specific information.

     *  if cancelled with {@link #cancelGetRequest cancelGetRequest}
     * @see javax.microedition.content.Registry#invoke
     * @see javax.microedition.content.ContentHandlerServer#finish
     */
    public Invocation getRequest(boolean wait) {
  Invocation request = new Invocation((InvocationImpl)null);
        InvocationImpl invoc = super.getRequest(wait, request);
        if (invoc != null) {
      // Wrap it in an Invocation instance
      request.setInvocImpl(invoc);
      return request;
        }
        return null;
    }

View Full Code Here

     *            objects
     * 
     * @see javax.microedition.content.RequestListener#invocationRequestNotify(ContentHandlerServer)
     */
    public void invocationRequestNotify(final ContentHandlerServer server) {
        final Invocation invoc = server.getRequest(false);
        if (invoc != null) {
            if (getActiveScreen() == null) {
                final String type = invoc.getType();


                final DemoMainScreen screen = new DemoMainScreen();
                screen.setTitle("Send Media Demo");


                if (type.equals("audio/mp4") || type.equals("audio/amr")
                        || type.equals("audio/mpeg")) {
                    screen.setType(DemoMainScreen.AUDIO_TYPE);


                    // Play an audio file
                    if (_audioPlayer == null) {
                        final String url = invoc.getURL();
                        screen.add(new LabelField("Playing audio file: " + url));


                        initAudio(url);
                    }
                }


                if (type.equals("image/bmp") || type.equals("image/png")
                        || type.equals("image/jpeg")) {
                    screen.setType(DemoMainScreen.IMAGE_TYPE);


                    // Get data from URL
                    final byte[] data = getData(invoc.getURL());


                    // Create image field
                    final Bitmap image =
                            Bitmap.createBitmapFromBytes(data, 0, -1, 5);
                    final BitmapField imageField =
                            new BitmapField(image, Field.FIELD_HCENTER);


                    screen.add(imageField);
                } else if (type.equals("video/3gpp")
                        || type.equals("video/mp4")) {
                    screen.setType(DemoMainScreen.VIDEO_TYPE);


                    // Play a video
                    initVideo(invoc.getURL());
                    if (_videoField != null) {
                        screen.add(_videoField);


                        try {
                            // Start video player

View Full Code Here

     * 
     * @see RequestListener#invocationRequestNotify(ContentHandlerServer)
     */
    public void invocationRequestNotify(final ContentHandlerServer server) {
        // Retrieve Invocation from the content handler server
        final Invocation invoc = server.getRequest(false);


        if (invoc == null) {
            return; // Nothing to do
        }


        int invocationStatus = invoc.getStatus();


        try {
            final Registry registry =
                    Registry.getRegistry(getClass().getName());
            final DefaultContentHandlerRegistry defaultRegistry =
                    DefaultContentHandlerRegistry
                            .getDefaultContentHandlerRegistry(registry);
            final ApplicationDescriptor descriptor =
                    defaultRegistry.getApplicationDescriptor(server.getID());


            Dialog.alert(descriptor.getName() + " invoked for: "
                    + invoc.getURL());


            // ...
            // Other processing could be done here
            // ...

View Full Code Here

    private Invocation getInvocation() {
        // The URL pointing to the location of the file we want to open
        // This file doesn't actually exist.
        final String url = "file:///rim." + DemoContentHandler.SUFFIXES[0];


        final Invocation invoc = new Invocation(url);
        invoc.setType(DemoContentHandler.TYPES[0]);
        invoc.setResponseRequired(false); // We don't require a response


        // We want to invoke a handler that has registered with ACTION_OPEN
        invoc.setAction(DemoContentHandler.ACTIONS[0]);


        return invoc;
    }

View Full Code Here

     * Creates an Invocation object and passes it to the Registry. Called by
     * 'Invoke' menu item.
     */
    private void doInvoke() {
        try {
            final Invocation invoc = getInvocation();


            // Get access to the Registry and pass it the Invocation
            _registry.invoke(invoc);
        } catch (final IOException ioe) {
            errorDialog("Registry#invoke() threw " + ioe.toString());

View Full Code Here

     * 
     * @return The new default handler name pulled from the
     *         ApplicationDescriptor
     */
    private String toggleDefaultHandler() {
        final Invocation invocation = getInvocation();
        String newDefaultHandlerName = null;


        try {
            final ContentHandler defaultHandler =
                    _defaultRegistry.getDefaultContentHandler(invocation);

View Full Code Here

                    DemoContentHandler.SUFFIXES, DemoContentHandler.ACTIONS,
                    DemoContentHandler.ID);


            // Get the app name for the current default handler
            try {
                final Invocation invocation = getInvocation();
                final ContentHandler defaultHandler =
                        _defaultRegistry.getDefaultContentHandler(invocation);
                final String id = defaultHandler.getID();
                final ApplicationDescriptor handlerDescriptor =
                        _defaultRegistry.getApplicationDescriptor(id);

View Full Code Here

TOP

Related Classes of javax.microedition.content.Invocation

blackberry.io.file.OpenFunction

com.blackberry.toolkit.sample.youtube.StartScreen$ThumbnailClick

com.rim.samples.device.chapidemo.CHAPIDemo

com.rim.samples.device.chapidemo.CHAPIDemo$CHAPIDemoScreen

com.rim.samples.device.chapidemo.DemoContentHandler

com.rim.samples.device.sendmediademo.SendMediaDemo

com.sun.midp.content.InvocationImpl

javax.microedition.content.ContentHandlerServerImpl

javax.microedition.io.Connection

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.

Examples of javax.microedition.content.Invocation

Invocation Status

Access to Content

Related Classes of javax.microedition.content.Invocation