org.osid.proxy

Interface Summary
Interface	Description
Proxy	A `Proxy` is used to transfer external information from an application server into an OSID Provider.
ProxyCondition	A `ProxyCondition` is used to transfer external information into a proxy.
ProxyManager	The proxy manager provides access to proxy sessions and provides interoperability tests for various aspects of this service.
ProxyProfile	The `ProxyProfile` describes the interoperability among proxy services.
ProxyProxyManager	The proxy proxy manager provides access to proxy sessions and provides interoperability tests for various aspects of this service.
ProxySession	This session converts external data into a proxy for use in OSID proxy managers.

Package org.osid.proxy Description

The Open Service Interface Definitions for the org.osid.proxy service.

The Proxy OSID helps a consumer map external data, such as that received via a server request, into a Proxy that can be used with OSID proxy managers. Then purpose of this OSID is to modularize assumptions made about the input data into another OSID Provider, such as the authentication or localization information.

The Proxy represents the OsidResult of an evaluation of the input OsidCondition performed by the Proxy OSID Provider. The resulting Proxy is meant to be passed to OsidProxyManagers. The Proxy OSID is the glue between the application server environment and the OSID services.

The input data may be anything acceptable to a ProxyCondition record Type. The ProxyCondition record Types are aligned with the application server environment while the Proxy record Types are aligned with OSID Providers. This alignment poses various interoperability issues and as such it might be helpful to be very broad in what may be specified in a ProxyCondition so that this service may produce the variety of Proxy records needed by the services in the OSID environment.

Some data is defined in the ProxyCondition. This in no way implies support of this input by an OSID Provider. The resulting OsidSession indicates what actually happened.

Example

An example using a specifier record for an http request:

      
      
      ProxyCondition condition = proxySession.getProxyCondition();
      HttpRequestRecord record = condition.getProxyConditionRecord(httpRequestRecordType);
      record.setHttpRequest(servletRequest);
      
      Proxy proxy = proxySession.getProxy(condition);

This Work is being provided by the copyright holder(s) subject to the following license. By obtaining, using and/or copying this Work, you agree that you have read, understand, and will comply with the following terms and conditions.

Permission to use, copy and distribute unmodified versions of this Work, for any purpose, without fee or royalty is hereby granted, provided that you include the above copyright notices and the terms of this license on ALL copies of the Work or portions thereof.

You may nodify or create Derivatives of this Work only for your internal purposes. You shall not distribute or transfer any such Derivative of this Work to any location or to any third party. For the purposes of this license, "Derivative" shall mean any derivative of the Work as defined in the United States Copyright Act of 1976, such as a translation or modification.

This Work and the information contained herein is provided on an "AS IS" basis WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE WORK OR THE USE OR OTHER DEALINGS IN THE WORK.

The export of software employing encryption technology may require a specific license from the United States Government. It is the responsibility of any person or organization contemplating export to obtain such a license before exporting this Work.