Capabilities (Jetspeed-2 Core API 2.1.3 API)

This project has retired. For details please refer to its Attic page.

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.apache.jetspeed.capabilities
Interface Capabilities

public interface Capabilities

Capabilities Component Interface

Version:: $Id: Capabilities.java 516448 2007-03-09 16:25:47Z ate $
Author:: Roger Ruttimann

Method Summary

Capability createCapability(String capabilityName)
          Create a new capability in the system or return the existing one if already exists

Client createClient(String clientName)
          Create a new client in the system or return the existing one if already exists

MediaType createMediaType(String mediaTypeName)
          Create a new mediaType in the system or return the existing one if already exists

MimeType createMimeType(String mimeTypeName)
          Create a new mimetype in the system or return the existing one if already exists

void deleteCapability(Capability capability)
          delete existing capability from backend storage

void deleteCapabilityMapCache()
          Clears CapabilityMap cache TODO: Roger, why is this on the public interface.

void deleteClient(Client client)
          delete existing client from backend storage

void deleteMediaType(MediaType mediaType)
          delete existing media type from backend storage

void deleteMimeType(MimeType mimeType)
          delete existing mime type from backend storage

Client findClient(String userAgent)
          Finds a client for a given userAgentPattern

Iterator getCapabilities()
          Obtain an iterator of all existing capabilities.

Capability getCapability(String capability)
          Given a capability string, look up the corresponding capability object.

String getCapabilityBeanName()
          Obtain the name of the CapabilityBean reference

CapabilityMap getCapabilityMap(String userAgent)
          Creates a Capability Map with Capabilities, Mimetypes and mediaTypes for the given UserAgentPattern

Client getClient(String clientName)
          Given a client name, look up the corresponding client object.

String getClientBeanName()
          Obtain the name of the ClientBean reference

Iterator getClients()
          Obtain an iterator of all existing clients.

MediaType getMediaType(String mediaType)
          Given a media type string, look up the corresponding media type object.

String getMediaTypeBeanName()
          Obtain the name of the Media Type reference

MediaType getMediaTypeForMimeType(String mimeTypeName)
          Given a Mimetype string lookup the corresponding media type object

Iterator getMediaTypes()
          Obtain an iterator of all existing media types.

Collection getMediaTypesForMimeTypes(Iterator mimetypes)
          Returns a collection of MediaTypes that matches the MimeTypes defined in the mimetype parameter

MimeType getMimeType(String mimeType)
          Given a mime type string, look up the corresponding mime type object.

String getMimeTypeBeanName()
          Obtain the name of the Mime Type reference

Iterator getMimeTypes()
          Obtain an iterator of all existing mime types.

void setCapabilityBeanName(String capabilityBeanName)
          Set the name of the CapabilityBean reference - used exclusively in IoC

void setClientBeanName(String clientBeanName)
          Set the name of the ClientBean reference - used exclusively in IoC

void setMediaTypeBeanName(String mediaTypeBeanName)
          Set the name of the MediaType bean reference - used exclusively in IoC

void setMimeTypeBeanName(String mimeTypeBeanName)
          Set the name of the MimeType bean reference - used exclusively in IoC

void storeCapability(Capability capability)
          Save capability to backend storage

void storeClient(Client client)
          Save client to backend storage

void storeMediaType(MediaType mediaType)
          Save media type to backend storage

void storeMimeType(MimeType mimeType)
          Save mime type to backend storage

Method Summary
`Capability`	`createCapability(String capabilityName)` Create a new capability in the system or return the existing one if already exists
`Client`	`createClient(String clientName)` Create a new client in the system or return the existing one if already exists
`MediaType`	`createMediaType(String mediaTypeName)` Create a new mediaType in the system or return the existing one if already exists
`MimeType`	`createMimeType(String mimeTypeName)` Create a new mimetype in the system or return the existing one if already exists
`void`	`deleteCapability(Capability capability)` delete existing capability from backend storage
`void`	`deleteCapabilityMapCache()` Clears CapabilityMap cache TODO: Roger, why is this on the public interface.
`void`	`deleteClient(Client client)` delete existing client from backend storage
`void`	`deleteMediaType(MediaType mediaType)` delete existing media type from backend storage
`void`	`deleteMimeType(MimeType mimeType)` delete existing mime type from backend storage
`Client`	`findClient(String userAgent)` Finds a client for a given userAgentPattern
`Iterator`	`getCapabilities()` Obtain an iterator of all existing capabilities.
`Capability`	`getCapability(String capability)` Given a capability string, look up the corresponding capability object.
`String`	`getCapabilityBeanName()` Obtain the name of the CapabilityBean reference
`CapabilityMap`	`getCapabilityMap(String userAgent)` Creates a Capability Map with Capabilities, Mimetypes and mediaTypes for the given UserAgentPattern
`Client`	`getClient(String clientName)` Given a client name, look up the corresponding client object.
`String`	`getClientBeanName()` Obtain the name of the ClientBean reference
`Iterator`	`getClients()` Obtain an iterator of all existing clients.
`MediaType`	`getMediaType(String mediaType)` Given a media type string, look up the corresponding media type object.
`String`	`getMediaTypeBeanName()` Obtain the name of the Media Type reference
`MediaType`	`getMediaTypeForMimeType(String mimeTypeName)` Given a Mimetype string lookup the corresponding media type object
`Iterator`	`getMediaTypes()` Obtain an iterator of all existing media types.
`Collection`	`getMediaTypesForMimeTypes(Iterator mimetypes)` Returns a collection of MediaTypes that matches the MimeTypes defined in the mimetype parameter
`MimeType`	`getMimeType(String mimeType)` Given a mime type string, look up the corresponding mime type object.
`String`	`getMimeTypeBeanName()` Obtain the name of the Mime Type reference
`Iterator`	`getMimeTypes()` Obtain an iterator of all existing mime types.
`void`	`setCapabilityBeanName(String capabilityBeanName)` Set the name of the CapabilityBean reference - used exclusively in IoC
`void`	`setClientBeanName(String clientBeanName)` Set the name of the ClientBean reference - used exclusively in IoC
`void`	`setMediaTypeBeanName(String mediaTypeBeanName)` Set the name of the MediaType bean reference - used exclusively in IoC
`void`	`setMimeTypeBeanName(String mimeTypeBeanName)` Set the name of the MimeType bean reference - used exclusively in IoC
`void`	`storeCapability(Capability capability)` Save capability to backend storage
`void`	`storeClient(Client client)` Save client to backend storage
`void`	`storeMediaType(MediaType mediaType)` Save media type to backend storage
`void`	`storeMimeType(MimeType mimeType)` Save mime type to backend storage

Method Detail

getCapabilityMap

CapabilityMap getCapabilityMap(String userAgent)
                               throws UnableToBuildCapabilityMapException

Creates a Capability Map with Capabilities, Mimetypes and mediaTypes for the given UserAgentPattern

Parameters:: userAgent - Agent from the request
Returns:: CapabilityMap populated with Capabilities, Mimetypes and Mediatype that match the userAgent. Never returns null
Throws:: UnableToBuildCapabilityMapException - If a capability could not be created

getClients

Iterator getClients()

Obtain an iterator of all existing clients.

Returns:: Returns an iterator for all existing Clients

findClient

Client findClient(String userAgent)

Finds a client for a given userAgentPattern

Parameters:: userAgent -
Returns:: Client that matches agent or null if no match is found

getMediaTypesForMimeTypes

Collection getMediaTypesForMimeTypes(Iterator mimetypes)

Returns a collection of MediaTypes that matches the MimeTypes defined in the mimetype parameter

Parameters:: Mimetype -
Returns:: Collection of Mediatypes that matches the mimetypes

deleteCapabilityMapCache

void deleteCapabilityMapCache()

Clears CapabilityMap cache TODO: Roger, why is this on the public interface. It seems to be impl specific

getMediaType

MediaType getMediaType(String mediaType)

Given a media type string, look up the corresponding media type object.

Parameters:: mediaType - The string representation of a media type.
Returns:: The found media type object or if not found, null.

getMediaTypeForMimeType

MediaType getMediaTypeForMimeType(String mimeTypeName)

Given a Mimetype string lookup the corresponding media type object

Parameters:: mimeTypeName - to use for lookup
Returns:: MediaTypeEntry that matches the lookup in the MEDIATYPE_TO_MIMETYPE table

getCapability

Capability getCapability(String capability)

Given a capability string, look up the corresponding capability object.

Parameters:: capability - The string representation of a capability.
Returns:: The found capability object or if not found, null.

getMimeType

MimeType getMimeType(String mimeType)

Given a mime type string, look up the corresponding mime type object.

Parameters:: mimeType - The string representation of a mime type.
Returns:: The found mime type object or if not found, null.

getClient

Client getClient(String clientName)

Given a client name, look up the corresponding client object.

Parameters:: clientName - The name of the client.
Returns:: The found client object or if not found, null.

getCapabilities

Iterator getCapabilities()

Obtain an iterator of all existing capabilities.

Returns:: Returns an iterator for all existing Capabilities of type Capability

getMimeTypes

Iterator getMimeTypes()

Obtain an iterator of all existing mime types.

Returns:: Returns an iterator for all existing Mime Types of type MimeType

getMediaTypes

Iterator getMediaTypes()

Obtain an iterator of all existing media types.

Returns:: Returns an iterator for all existing media types of type MediaType

getCapabilityBeanName

String getCapabilityBeanName()

Obtain the name of the CapabilityBean reference

Returns:: ref-id of the capability bean

setCapabilityBeanName

void setCapabilityBeanName(String capabilityBeanName)

Set the name of the CapabilityBean reference - used exclusively in IoC

Parameters:: capabilityBeanName - The ref-id of the capability bean.

getClientBeanName

String getClientBeanName()

Obtain the name of the ClientBean reference

Returns:: ref-id of the client bean

setClientBeanName

void setClientBeanName(String clientBeanName)

Set the name of the ClientBean reference - used exclusively in IoC

Parameters:: clientBeanName - The ref-id of the client bean.

getMediaTypeBeanName

String getMediaTypeBeanName()

Obtain the name of the Media Type reference

Returns:: ref-id of the media type bean

setMediaTypeBeanName

void setMediaTypeBeanName(String mediaTypeBeanName)

Set the name of the MediaType bean reference - used exclusively in IoC

Parameters:: mediaTypeBeanName - The ref-id of the mediaType bean.

getMimeTypeBeanName

String getMimeTypeBeanName()

Obtain the name of the Mime Type reference

Returns:: ref-id of the mime type bean

setMimeTypeBeanName

void setMimeTypeBeanName(String mimeTypeBeanName)

Set the name of the MimeType bean reference - used exclusively in IoC

Parameters:: mimeTypeBeanName - The ref-id of the mimeType bean.

createCapability

Capability createCapability(String capabilityName)
                            throws ClassNotFoundException

Create a new capability in the system or return the existing one if already exists

Parameters:: capabilityName - The string describing the capability
Returns:: A new (or existing) capability
Throws:: ClassNotFoundException

createMimeType

MimeType createMimeType(String mimeTypeName)
                        throws ClassNotFoundException

Create a new mimetype in the system or return the existing one if already exists

Parameters:: mimeTypeName - The string describing the mimeType
Returns:: A new (or existing) MimeType
Throws:: ClassNotFoundException

createMediaType

MediaType createMediaType(String mediaTypeName)
                          throws ClassNotFoundException

Create a new mediaType in the system or return the existing one if already exists

Parameters:: mediaTypeName - The string describing the mediaType
Returns:: A new (or existing) MediaType
Throws:: ClassNotFoundException

createClient

Client createClient(String clientName)
                    throws ClassNotFoundException

Create a new client in the system or return the existing one if already exists

Parameters:: clientName - The string describing the client
Returns:: A new (or existing) client
Throws:: ClassNotFoundException

storeMediaType

void storeMediaType(MediaType mediaType)
                    throws CapabilitiesException

Save media type to backend storage

Parameters:: mediaType - valid mediatype object
Throws:: CapabilitiesException

deleteMediaType

void deleteMediaType(MediaType mediaType)
                     throws CapabilitiesException

delete existing media type from backend storage

Parameters:: mediaType - valid mediatype object
Throws:: CapabilitiesException

storeCapability

void storeCapability(Capability capability)
                     throws CapabilitiesException

Save capability to backend storage

Parameters:: capability - valid capability object
Throws:: CapabilitiesException

deleteCapability

void deleteCapability(Capability capability)
                      throws CapabilitiesException

delete existing capability from backend storage

Parameters:: capability - valid capability object
Throws:: CapabilitiesException

storeMimeType

void storeMimeType(MimeType mimeType)
                   throws CapabilitiesException

Save mime type to backend storage

Parameters:: mimeType - valid mimetype object
Throws:: CapabilitiesException

deleteMimeType

void deleteMimeType(MimeType mimeType)
                    throws CapabilitiesException

delete existing mime type from backend storage

Parameters:: mimeType - valid mimetype object
Throws:: CapabilitiesException

storeClient

void storeClient(Client client)
                 throws CapabilitiesException

Save client to backend storage

Parameters:: client - valid Client object
Throws:: CapabilitiesException

deleteClient

void deleteClient(Client client)
                  throws CapabilitiesException

delete existing client from backend storage

Parameters:: client - valid client object
Throws:: CapabilitiesException