org.apache.olingo.odata2.api.ep

Class EntityProvider

java.lang.Object

org.apache.olingo.odata2.api.ep.EntityProvider

public final class EntityProvider
extends Object

Entity Provider

An EntityProvider provides all necessary read and write methods for accessing the entities defined in an Entity Data Model. Therefore this library provides (in its core packages) as convenience basic entity providers for accessing entities in the XML and JSON formats.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	EntityProvider.EntityProviderInterface (Internal) interface for all EntityProvider necessary read and write methods for accessing entities defined in an Entity Data Model.

Constructor Summary

Constructors

Constructor and Description
EntityProvider()

Method Summary

Modifier and Type	Method and Description
static List<BatchRequestPart>	parseBatchRequest(String contentType, InputStream content, EntityProviderBatchProperties properties) Parse Batch Request body inputStream (as InputStream) and provide a list of Batch Request parts as BatchRequestPart
static List<BatchSingleResponse>	parseBatchResponse(InputStream content, String contentType) Parse Batch Response body (as InputStream) and provide a list of single responses as BatchSingleResponse
static byte[]	readBinary(InputStream content) Read (de-serialize) binary data from content (as InputStream) and provide it as byte[].
static ODataDeltaFeed	readDeltaFeed(String contentType, EdmEntitySet entitySet, InputStream content, EntityProviderReadProperties properties) Read (de-serialize) a delta data feed from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmEntitySet) and provide this data as ODataEntry .
static ODataEntry	readEntry(String contentType, EdmEntitySet entitySet, InputStream content, EntityProviderReadProperties properties) Read (de-serialize) data from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmEntitySet) and provide this data as ODataEntry .
static ODataErrorContext	readErrorDocument(InputStream errorDocument, String contentType) Read (de-serialize) data from error document as InputStream and provide according ODataErrorContext .
static ODataFeed	readFeed(String contentType, EdmEntitySet entitySet, InputStream content, EntityProviderReadProperties properties) Read (de-serialize) a data feed from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmEntitySet) and provide this data as ODataEntry .
static Object	readFunctionImport(String contentType, EdmFunctionImport functionImport, InputStream content, EntityProviderReadProperties properties) Reads (de-serializes) function-import data from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmFunctionImport) and provide this data as Object.
static String	readLink(String contentType, EdmEntitySet entitySet, InputStream content) Read (de-serialize) a link from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmEntitySet) and provide the link as String.
static List<String>	readLinks(String contentType, EdmEntitySet entitySet, InputStream content) Read (de-serialize) a link collection from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmEntitySet) and provide the links as List of Strings.
static Edm	readMetadata(InputStream metadataXml, boolean validate) Read (de-serialize) data from metadata inputStream (as InputStream) and provide Edm as Edm
static Map<String,Object>	readProperty(String contentType, EdmProperty edmProperty, InputStream content, EntityProviderReadProperties properties) Read (de-serialize) properties from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmProperty) and provide this data as Map which contains the read data in form of property name to property value mapping.
static Object	readPropertyValue(EdmProperty edmProperty, InputStream content) Read (de-serialize) a property value from content (as InputStream) in format text/plain based on entity data model (given as EdmProperty) and provide this data as Object.
static Object	readPropertyValue(EdmProperty edmProperty, InputStream content, Class<?> typeMapping) Read (de-serialize) a property value from content (as InputStream) in format text/plain based on entity data model (given as EdmProperty) and provide this data as Object.
static ServiceDocument	readServiceDocument(InputStream serviceDocument, String contentType) Read (de-serialize) data from service document inputStream (as InputStream) and provide ServiceDocument as ServiceDocument
static InputStream	writeBatchRequest(List<BatchPart> batchParts, String boundary) Create Batch Request body as InputStream.
static ODataResponse	writeBatchResponse(List<BatchResponsePart> batchResponseParts) Write responses of Batch Response Parts in Batch Response as ODataResponse.
static ODataResponse	writeBinary(String mimeType, byte[] data) Write binary content with content type header set to given mime type parameter.
static ODataResponse	writeEntry(String contentType, EdmEntitySet entitySet, Map<String,Object> data, EntityProviderWriteProperties properties) Write given data (which is given in form of a Map for which contains all properties as property name to property value mapping) for the entry in the specified format (given as contentType) based on entity data model for an entity set (given as EdmEntitySet) and properties for this entity provider (given as EntityProviderWriteProperties).
static ODataResponse	writeErrorDocument(ODataErrorContext context) Serializes an error message according to the OData standard.
static ODataResponse	writeFeed(String contentType, EdmEntitySet entitySet, List<Map<String,Object>> data, EntityProviderWriteProperties properties) Write given data (which is given in form of a List with a Map for each entity.
static ODataResponse	writeFunctionImport(String contentType, EdmFunctionImport functionImport, Object data, EntityProviderWriteProperties properties) Write data result (given as Object) of function import based on return type of EdmFunctionImport in specified format (given as contentType).
static ODataResponse	writeLink(String contentType, EdmEntitySet entitySet, Map<String,Object> data, EntityProviderWriteProperties properties) Write link for key property based on entity data model for an entity set (given as EdmEntitySet) in the specified format (given as contentType).
static ODataResponse	writeLinks(String contentType, EdmEntitySet entitySet, List<Map<String,Object>> data, EntityProviderWriteProperties properties) Write all links for key property based on entity data model for an entity set (given as EdmEntitySet) in the specified format (given as contentType) for a set of entries.
static ODataResponse	writeMetadata(DataServices serviceMetadata, Map<String,String> predefinedNamespaces) Write metadata document in XML format for the given schemas and the provided predefined namespaces at the EDMX element.
static ODataResponse	writeMetadata(List<Schema> schemas, Map<String,String> predefinedNamespaces) Write metadata document in XML format for the given schemas and the provided predefined namespaces at the EDMX element.
static ODataResponse	writeProperty(String contentType, EdmProperty edmProperty, Object value) Write given value (which is given in form of an Object) for the property in the specified format (given as contentType) based on given entity data model for an entity property (given as EdmProperty).
static ODataResponse	writePropertyValue(EdmProperty edmProperty, Object value) Write property as content type application/octet-stream or text/plain.
static ODataResponse	writeServiceDocument(String contentType, Edm edm, String serviceRoot) Write service document based on given Edm and service root as given content type.
static ODataResponse	writeText(String value) Write text value as content type text/plain.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EntityProvider

public EntityProvider()

Method Detail

writeErrorDocument

public static ODataResponse writeErrorDocument(ODataErrorContext context)

Serializes an error message according to the OData standard.

An exception is not thrown because this method is used in exception handling.

Parameters:

context - contains error details see ODataErrorContext

Returns:

an ODataResponse containing the serialized error message

writeMetadata

public static ODataResponse writeMetadata(List<Schema> schemas,
                                          Map<String,String> predefinedNamespaces)
                                   throws EntityProviderException

Write metadata document in XML format for the given schemas and the provided predefined namespaces at the EDMX element. PredefinedNamespaces is of type Map<prefix,namespace> and may be null or an empty Map.

Parameters:

schemas - all XML schemas which will be written

predefinedNamespaces - type of Map<prefix,namespace> and may be null or an empty Map

Returns:

resulting ODataResponse with written metadata content.

Throws:

EntityProviderException - if writing of data (serialization) fails

writeMetadata

public static ODataResponse writeMetadata(DataServices serviceMetadata,
                                          Map<String,String> predefinedNamespaces)
                                   throws EntityProviderException

Write metadata document in XML format for the given schemas and the provided predefined namespaces at the EDMX element. PredefinedNamespaces is of type Map<prefix,namespace> and may be null or an empty Map.

Parameters:

serviceMetadata -

predefinedNamespaces - type of Map<prefix,namespace> and may be null or an empty Map

Returns:

resulting ODataResponse with written metadata content.

Throws:

EntityProviderException - if writing of data (serialization) fails

writeServiceDocument

public static ODataResponse writeServiceDocument(String contentType,
                                                 Edm edm,
                                                 String serviceRoot)
                                          throws EntityProviderException

Write service document based on given Edm and service root as given content type.

Parameters:

contentType - format in which service document should be written

edm - entity data model to be written

serviceRoot - service root for the written service document

Returns:

resulting ODataResponse with written service document content.

Throws:

EntityProviderException - if writing of data (serialization) fails

writePropertyValue

public static ODataResponse writePropertyValue(EdmProperty edmProperty,
                                               Object value)
                                        throws EntityProviderException

Write property as content type application/octet-stream or text/plain.

Parameters:

edmProperty - entity data model for to be written property

value - property which will be written

Returns:

resulting ODataResponse with written property value content.

Throws:

EntityProviderException - if writing of data (serialization) fails

writeText

public static ODataResponse writeText(String value)
                               throws EntityProviderException

Write text value as content type text/plain.

Parameters:

value - text value which will be written

Returns:

resulting ODataResponse with written text/plain content.

Throws:

EntityProviderException - if writing of data (serialization) fails

writeBinary

public static ODataResponse writeBinary(String mimeType,
                                        byte[] data)
                                 throws EntityProviderException

Write binary content with content type header set to given mime type parameter.

Parameters:

mimeType - mime type which is written and used as content type header information.

data - which is written to ODataResponse.

Returns:

response object resulting ODataResponse with written binary content.

Throws:

EntityProviderException - if writing of data (serialization) fails

writeFeed

public static ODataResponse writeFeed(String contentType,
                                      EdmEntitySet entitySet,
                                      List<Map<String,Object>> data,
                                      EntityProviderWriteProperties properties)
                               throws EntityProviderException

Write given data (which is given in form of a List with a Map for each entity. Such a Map contains all properties [as property name to property value mapping] for the entry) in the specified format (given as contentType) based on given entity data model for an entity set (given as EdmEntitySet) and properties for this entity provider (given as EntityProviderWriteProperties).

Parameters:

contentType - format in which the feed should be written

entitySet - entity data model for given entity data set

data - set of entries in form of a List with a Map for each entity (such a Map contains all properties [as property name to property value mapping).

properties - additional properties necessary for writing of data

Returns:

resulting ODataResponse with written feed content.

Throws:

EntityProviderException - if writing of data (serialization) fails

writeEntry

public static ODataResponse writeEntry(String contentType,
                                       EdmEntitySet entitySet,
                                       Map<String,Object> data,
                                       EntityProviderWriteProperties properties)
                                throws EntityProviderException

Write given data (which is given in form of a Map for which contains all properties as property name to property value mapping) for the entry in the specified format (given as contentType) based on entity data model for an entity set (given as EdmEntitySet) and properties for this entity provider (given as EntityProviderWriteProperties).

Parameters:

contentType - format in which the entry should be written

entitySet - entity data model for given entity data set

data - which contains all properties as property name to property value mapping for the entry

properties - additional properties necessary for writing of data

Returns:

resulting ODataResponse with written entry content

Throws:

EntityProviderException - if writing of data (serialization) fails

writeProperty

public static ODataResponse writeProperty(String contentType,
                                          EdmProperty edmProperty,
                                          Object value)
                                   throws EntityProviderException

Write given value (which is given in form of an Object) for the property in the specified format (given as contentType) based on given entity data model for an entity property (given as EdmProperty).

Parameters:

contentType - format in which the property should be written

edmProperty - entity data model for given property

value - data which is written

Returns:

resulting ODataResponse with written property content.

Throws:

EntityProviderException - if writing of data (serialization) fails

writeLink

public static ODataResponse writeLink(String contentType,
                                      EdmEntitySet entitySet,
                                      Map<String,Object> data,
                                      EntityProviderWriteProperties properties)
                               throws EntityProviderException

Write link for key property based on entity data model for an entity set (given as EdmEntitySet) in the specified format (given as contentType). The necessary key property values must be provided within the data (in the form of property name to property value mapping) and properties for this entity provider must be set (given as EntityProviderWriteProperties).

Parameters:

contentType - format in which the entry should be written

entitySet - entity data model for given entity data set

data - which contains all key properties as property name to property value mapping for the entry

properties - additional properties necessary for writing of data

Returns:

resulting ODataResponse with written link content.

Throws:

EntityProviderException - if writing of data (serialization) fails

writeLinks

public static ODataResponse writeLinks(String contentType,
                                       EdmEntitySet entitySet,
                                       List<Map<String,Object>> data,
                                       EntityProviderWriteProperties properties)
                                throws EntityProviderException

Write all links for key property based on entity data model for an entity set (given as EdmEntitySet) in the specified format (given as contentType) for a set of entries. The necessary key property values must be provided within the data (in form of a List with a Map for each entry. Such a Map contains all key properties [as property name to property value mapping] for the entry) and properties for this entity provider must be set (given as EntityProviderWriteProperties).

Parameters:

contentType - format in which the entry should be written

entitySet - entity data model for given entity data set

data - set of entries in form of a List with a Map for each entry (such a Map contains all key properties [as property name to property value mapping).

properties - additional properties necessary for writing of data

Returns:

resulting ODataResponse with written links content.

Throws:

EntityProviderException - if writing of data (serialization) fails

writeFunctionImport

public static ODataResponse writeFunctionImport(String contentType,
                                                EdmFunctionImport functionImport,
                                                Object data,
                                                EntityProviderWriteProperties properties)
                                         throws EntityProviderException

Write data result (given as Object) of function import based on return type of EdmFunctionImport in specified format (given as contentType). Additional properties for this entity provider must be set (given as EntityProviderWriteProperties).

Parameters:

contentType - format in which the entry should be written

functionImport - entity data model for executed function import

data - result of function import

properties - additional properties necessary for writing of data

Returns:

resulting ODataResponse with written function import result content.

Throws:

EntityProviderException - if writing of data (serialization) fails

readFeed

public static ODataFeed readFeed(String contentType,
                                 EdmEntitySet entitySet,
                                 InputStream content,
                                 EntityProviderReadProperties properties)
                          throws EntityProviderException

Read (de-serialize) a data feed from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmEntitySet) and provide this data as ODataEntry .

Parameters:

contentType - format of content in the given input stream.

entitySet - entity data model for entity set to be read

content - feed data in form of an InputStream which contains the data in specified format

properties - additional properties necessary for reading content from InputStream into Map. Must not be null.

Returns:

an ODataFeed object

Throws:

EntityProviderException - if reading of data (de-serialization) fails

readDeltaFeed

public static ODataDeltaFeed readDeltaFeed(String contentType,
                                           EdmEntitySet entitySet,
                                           InputStream content,
                                           EntityProviderReadProperties properties)
                                    throws EntityProviderException

Read (de-serialize) a delta data feed from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmEntitySet) and provide this data as ODataEntry .

Parameters:

contentType - format of content in the given input stream.

entitySet - entity data model for entity set to be read

content - feed data in form of an InputStream which contains the data in specified format

properties - additional properties necessary for reading content from InputStream into Map. Must not be null.

Returns:

an ODataDeltaFeed object

Throws:

EntityProviderException - if reading of data (de-serialization) fails

readEntry

public static ODataEntry readEntry(String contentType,
                                   EdmEntitySet entitySet,
                                   InputStream content,
                                   EntityProviderReadProperties properties)
                            throws EntityProviderException

Read (de-serialize) data from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmEntitySet) and provide this data as ODataEntry .

Parameters:

contentType - format of content in the given input stream.

entitySet - entity data model for entity set to be read

content - data in form of an InputStream which contains the data in specified format

properties - additional properties necessary for reading content from InputStream into Map. Must not be null.

Returns:

entry as ODataEntry

Throws:

EntityProviderException - if reading of data (de-serialization) fails

readProperty

public static Map<String,Object> readProperty(String contentType,
                                              EdmProperty edmProperty,
                                              InputStream content,
                                              EntityProviderReadProperties properties)
                                       throws EntityProviderException

Read (de-serialize) properties from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmProperty) and provide this data as Map which contains the read data in form of property name to property value mapping.

Parameters:

contentType - format of content in the given input stream.

edmProperty - entity data model for entity property to be read

content - data in form of an InputStream which contains the data in specified format

properties - additional properties necessary for reading content from InputStream into Map. Must not be null.

Returns:

property as name and value in a map

Throws:

EntityProviderException - if reading of data (de-serialization) fails

readPropertyValue

public static Object readPropertyValue(EdmProperty edmProperty,
                                       InputStream content)
                                throws EntityProviderException

Read (de-serialize) a property value from content (as InputStream) in format text/plain based on entity data model (given as EdmProperty) and provide this data as Object.

Parameters:

edmProperty - entity data model for entity property to be read

content - data in form of an InputStream which contains the data in format text/plain

Returns:

property value as object

Throws:

EntityProviderException - if reading of data (de-serialization) fails

readPropertyValue

public static Object readPropertyValue(EdmProperty edmProperty,
                                       InputStream content,
                                       Class<?> typeMapping)
                                throws EntityProviderException

Read (de-serialize) a property value from content (as InputStream) in format text/plain based on entity data model (given as EdmProperty) and provide this data as Object.

Parameters:

edmProperty - entity data model for entity property to be read

content - data in form of an InputStream which contains the data in format text/plain

typeMapping - defines the mapping for this edm property to a java class which should be used during read of the content. If according edm property can not be read into given java class an EntityProviderException is thrown. Supported mappings are documented in EdmSimpleType.

Returns:

property value as object

Throws:

EntityProviderException - if reading of data (de-serialization) fails

readFunctionImport

public static Object readFunctionImport(String contentType,
                                        EdmFunctionImport functionImport,
                                        InputStream content,
                                        EntityProviderReadProperties properties)
                                 throws EntityProviderException

Reads (de-serializes) function-import data from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmFunctionImport) and provide this data as Object.

Parameters:

contentType - format of content in the given input stream.

functionImport - entity data model for Function Import to be read

content - data in form of an InputStream which contains the data in specified format

properties - additional properties necessary for reading content from InputStream into Map. Must not be null.

Returns:

data as Object

Throws:

EntityProviderException - if reading of data (de-serialization) fails

readLink

public static String readLink(String contentType,
                              EdmEntitySet entitySet,
                              InputStream content)
                       throws EntityProviderException

Read (de-serialize) a link from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmEntitySet) and provide the link as String.

Parameters:

contentType - format of content in the given input stream.

entitySet - entity data model for entity property to be read

content - data in form of an InputStream which contains the data in specified format

Returns:

link as string

Throws:

EntityProviderException - if reading of data (de-serialization) fails

readLinks

public static List<String> readLinks(String contentType,
                                     EdmEntitySet entitySet,
                                     InputStream content)
                              throws EntityProviderException

Read (de-serialize) a link collection from content (as InputStream) in specified format (given as contentType) based on entity data model (given as EdmEntitySet) and provide the links as List of Strings.

Parameters:

contentType - format of content in the given input stream.

entitySet - entity data model for entity property to be read

content - data in form of an InputStream which contains the data in specified format

Returns:

links as List of Strings

Throws:

EntityProviderException - if reading of data (de-serialization) fails

readBinary

public static byte[] readBinary(InputStream content)
                         throws EntityProviderException

Read (de-serialize) binary data from content (as InputStream) and provide it as byte[].

Parameters:

content - data in form of an InputStream which contains the binary data

Returns:

binary data as bytes

Throws:

EntityProviderException - if reading of data (de-serialization) fails

readMetadata

public static Edm readMetadata(InputStream metadataXml,
                               boolean validate)
                        throws EntityProviderException

Read (de-serialize) data from metadata inputStream (as InputStream) and provide Edm as Edm

Parameters:

metadataXml - a metadata xml input stream (means the metadata document)

validate - has to be true if metadata should be validated

Returns:

Edm as Edm

Throws:

EntityProviderException - if reading of data (de-serialization) fails

readErrorDocument

public static ODataErrorContext readErrorDocument(InputStream errorDocument,
                                                  String contentType)
                                           throws EntityProviderException

Read (de-serialize) data from error document as InputStream and provide according ODataErrorContext .

Parameters:

errorDocument - error document which is read

contentType - format of content in the given input stream

Returns:

read error document

Throws:

EntityProviderException - if reading of data (de-serialization) fails

readServiceDocument

public static ServiceDocument readServiceDocument(InputStream serviceDocument,
                                                  String contentType)
                                           throws EntityProviderException

Read (de-serialize) data from service document inputStream (as InputStream) and provide ServiceDocument as ServiceDocument

Parameters:

serviceDocument - the given input stream

contentType - format of content in the given input stream

Returns:

ServiceDocument as ServiceDocument

Throws:

EntityProviderException - if reading of data (de-serialization) fails

parseBatchRequest

public static List<BatchRequestPart> parseBatchRequest(String contentType,
                                                       InputStream content,
                                                       EntityProviderBatchProperties properties)
                                                throws BatchException

Parse Batch Request body inputStream (as InputStream) and provide a list of Batch Request parts as BatchRequestPart

Parameters:

contentType - format of content in the given input stream

content - request body

properties - additional properties necessary for parsing. Must not be null.

Returns:

list of BatchRequestPart

Throws:

BatchException - if parsing fails

writeBatchResponse

public static ODataResponse writeBatchResponse(List<BatchResponsePart> batchResponseParts)
                                        throws BatchException

Write responses of Batch Response Parts in Batch Response as ODataResponse. Batch Response body matches one-to-one with the corresponding Batch Request body

Parameters:

batchResponseParts - a list of BatchResponsePart

Returns:

Batch Response as ODataResponse

Throws:

BatchException

writeBatchRequest

public static InputStream writeBatchRequest(List<BatchPart> batchParts,
                                            String boundary)

Create Batch Request body as InputStream.

Parameters:

batchParts - a list of BatchPartRequests BatchPart

boundary -

Returns:

Batch Request as InputStream

parseBatchResponse

public static List<BatchSingleResponse> parseBatchResponse(InputStream content,
                                                           String contentType)
                                                    throws BatchException

Parse Batch Response body (as InputStream) and provide a list of single responses as BatchSingleResponse

Parameters:

content - response body

contentType - format of content in the given input stream (inclusive boundary parameter)

Returns:

list of BatchSingleResponse

Throws:

BatchException