# Package oracle.adf.view.rich.remote

A package for making a connection to a remote application server to retrieve data.

See: Description

- Interface Summary
  Interface | Description
  --- | ---
  AuthorizationProvider | This interface will add an itentity or authorization to a RemoteApplicationRequest.
  PhaseRunnable | Implemented by all classes that wish to be queued on the RemoteApplicationContext in order to run durring the JSF lifecycle.
  TaskResult |

- Class Summary
  Class | Description
  --- | ---
  CookieWrapper | The RemoteApplicationFramework needs to use two cookie types on a regular basis.
  NonSerializableProducerException | This is sent back to the producer instead of another message when a particular exception is not serializable.
  RemoteApplication | This is a reference to a remote web application.
  RemoteApplicationContext | The RemoteApplicationContext is a context used when the richclient is running as a producer using the RemoteApplication framework.
  RemoteApplicationInstance | While the `RemoteApplication` references a webapp url that hosts an application, the RemoteApplicationInstance hosts a specific instance to the remote region.
  RemoteApplicationInstanceRaw |
  RemoteApplicationRequest | This is the request object into the remote application.
  RemoteApplicationResponse | The response returned from a remote application request.
  RemoteApplicationResponseGenerator | Generates various types of RemoteApplicationResponses.
  RemoteApplicationUtils | This is the workhorse of the Remote Application subsystem.
  RemoteRegionListenerContext | Provides a context for RemoteRegionListeners so that they can extend their functionality based on a particular RemoteRegionModel.
  TaskHandler | This is the interface for a TaskHandler.
  TaskInvocation | Stores information about a task invocation for this request.

- Enum Summary
  Enum | Description
  --- | ---
  RemoteApplicationRequest.Operation | An enumeration of request types.
  RemoteApplicationResponse.Status | The status of the execution result.
  RemoteApplicationResponse.Type | This returns the type of response.

- Exception Summary
  Exception | Description
  --- | ---
  HttpException | This exception is added to an ERROR response when there was a connecton issue of some kind.
  NotAuthorizedException | This exception is thrown when the RemoteApplication framework is unable to successfully authorize to a remote application.

## Package oracle.adf.view.rich.remote Description

A package for making a connection to a remote application server to retrieve data. The RemoteTaskflow framework consists of two sub-systems. The Remote Region subsystem which provides interfaces to the model and the JSF level framework, and the Remote Application subsystem which forms the foundation for the communications channel. This package contains the classes that comprise the Remote Application subsystem.

The primary workhorse of this framework is the `RemoteApplicationUtils.run(RemoteApplicationRequest)` method which actually makes the call to the remote server. Likewise, the part that provides the real "magic" of the framework exists in the `TaskHandler` subclasses which perform the actual work for setting up the environment on the producer side.

Finally this subsustem supports the ability to handle remote authorization via the `AuthorizationProvider` so that single sign-on may be achieved for any request into the remote application.

Generally speaking this package will be used by the Remote Region subsystem to make the connection, but it can be used by other subsystems as well to retrieve information or content about the remote server.

Copyright (c) 1998, 2018, Oracle and/or its affiliates. All rights reserved.