|
Oracle Fusion Middleware Java API Reference for Oracle ADF Model 11g Release 1 (11.1.1) E10653-04 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object oracle.adf.model.adapter.AbstractDefinition oracle.adfinternal.model.adapter.webservice.WSDefinition
public class WSDefinition
/** Definition of the WebService data control instance.
The webservice data control definitions can be created in following ways
#loadFromMetadata(Node, HashMap)
to load from the metadata definition. Once the definition is loaded,
it calls the createDataControl()
to create the data control
instance.
AbstractDefinition
Field Summary | |
---|---|
static java.lang.String |
ATTR_CONNECTION
Connection Attribute for the Adapter. |
static java.lang.String |
ATTR_DATATYPE
Part Datatype attribute |
static java.lang.String |
ATTR_FORMAT
Format attribute |
static java.lang.String |
ATTR_NAME
Name attribute |
static java.lang.String |
ATTR_NAMESPACE
Operation Name Space Attribute |
static java.lang.String |
ATTR_PROVIDER
Provider element, describes the underlying invocation provider for the data control. |
static java.lang.String |
ATTR_VERSION
Version attribute |
static java.lang.String |
ATTR_WSDL
WSDL attribute |
static java.lang.String |
ELEM_DATAFORMAT
Data Format element, describes a Data format |
static java.lang.String |
ELEM_DEFINITION
The definition node for this data control |
static java.lang.String |
ELEM_OPERATION
Operation Element |
static java.lang.String |
ELEM_PORT
Port Element, describes a port. |
static java.lang.String |
ELEM_SERVICE
Service Element in the XML Metadata file |
static java.lang.String |
LOGGER
|
static java.lang.String |
XMLNS
Namespace in which this metadata is defined |
Fields inherited from class oracle.adf.model.adapter.AbstractDefinition |
---|
CACHE_TO_CLASSPATH, CACHE_TO_SOURCEPATH, DONT_CACHE |
Fields inherited from interface oracle.binding.meta.Definition |
---|
TYPE_ACCESSOR, TYPE_ATTRIBUTE, TYPE_CRITERIA, TYPE_CRITERIA_ITEM, TYPE_CRITERIA_OPERATOR, TYPE_CRITERIA_ROW, TYPE_DATACONTROL, TYPE_DEFINITION, TYPE_DEFINITIONCONTEXT, TYPE_NAMED, TYPE_OPERATION, TYPE_OPERATIONRETURN, TYPE_PARAMETER, TYPE_STRUCTURE, TYPE_VARIABLE |
Constructor Summary | |
---|---|
WSDefinition()
Create this Data Control defintion |
|
WSDefinition(java.lang.String name,
java.net.URL wsdlURL)
Create this Data control definition instance. |
|
WSDefinition(java.lang.String name,
java.net.URL wsdlURL,
WSModel model,
javax.xml.namespace.QName serviceName)
Create this Data control definition instance from the WSDL url and the model representing the service. |
|
WSDefinition(java.net.URL wsdlURL)
Create this Data Control defintion from the WSDL source |
Method Summary | |
---|---|
void |
bindServiceConnection(javax.naming.Context context)
Bind the underlying connection used by this data control into the context provided by the caller. |
DataControl |
createDataControl()
Creates an instance of the Webservice data control generated from the metadata definition. |
protected void |
destroy()
Destroy this definition instance. |
java.lang.String |
getAdapterType()
Get the adapter type of this data control. |
java.lang.String |
getDCName()
Get the name of the Data control for which this Definition is created. |
java.util.Map |
getDCOperations()
Get the operations that the data control can invoke on the service |
java.util.Map |
getDefaultDCOperations(javax.xml.namespace.QName serviceName)
Get the Default operations for a given service. |
Node |
getMetadata()
Returns the element that defines the metadata for the data control. |
WSModel |
getModel()
Get the underlying webservice model for this definition's source. |
java.lang.String |
getRootStructureName()
Get the root structure definition name for this dc |
SecurityModel |
getSecurityModel()
Get the underlying security model for this Data control. |
javax.xml.namespace.QName |
getServiceName()
Get the default service name for this Data control definition |
StructureDefinition |
getStructure()
Get the strcuture definition for the data |
java.net.URL |
getWSDL()
|
boolean |
isStructureDirty(boolean refresh)
Tells the framework whether the Data control structure is dirty and needs to be refreshed on the palette. |
boolean |
isSupported(java.lang.String flag)
Indicates if the adapter support things like sorting, transaction etc. |
void |
loadFromMetadata(Node node,
java.util.Map params)
Loads the definition from a metadata Node . |
void |
refresh()
Refresh the underlying model of the data control. |
void |
setDCOperations(java.util.Map dcOperations)
Set the Data control operations in this Defintion. |
void |
setRootStructureName(java.lang.String rootDefName)
Set the qualified root structure def name for this dc structure |
void |
setServiceName(javax.xml.namespace.QName serviceName)
Set the Service Name for this data control definition |
Methods inherited from class oracle.adf.model.adapter.AbstractDefinition |
---|
assignDefaultPackage, createDuplicateDetailIterator, getAdapterContext, getCachingMode, getDefClassName, getDefinitionParent, getDefinitionType, getFactoryClassName, getFullName, getName, getParameters, getProperties, getProperty, setAdapterContext, setCompileProjectOnCreate, setName, setProperty, shouldCompileProjectOnCreate, shouldStoreStructureDefinition, usePersistedStructure |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final java.lang.String XMLNS
public static final java.lang.String ELEM_DEFINITION
public static final java.lang.String ELEM_SERVICE
public static final java.lang.String ELEM_OPERATION
public static final java.lang.String ELEM_PORT
public static final java.lang.String ELEM_DATAFORMAT
public static final java.lang.String ATTR_FORMAT
public static final java.lang.String ATTR_PROVIDER
public static final java.lang.String ATTR_CONNECTION
public static final java.lang.String ATTR_NAME
public static final java.lang.String ATTR_NAMESPACE
public static final java.lang.String ATTR_DATATYPE
public static final java.lang.String ATTR_WSDL
public static final java.lang.String ATTR_VERSION
public static final java.lang.String LOGGER
Constructor Detail |
---|
public WSDefinition()
public WSDefinition(java.net.URL wsdlURL) throws AdapterException
wsdlURL
- The WSDL URL
describing the service.
{@link
- AdapterException} if the data control definition
cannot be created from the WSDL URL
AdapterException
public WSDefinition(java.lang.String name, java.net.URL wsdlURL) throws AdapterException
name
- The name of the data control for which the definition
is being created.wsdlURL
- The URL of the service description.
{@link
- AdapterException} if the definition for this data
control could be created. This failure may happen if the
WSDL url is invalid and the model cannot be initialized.
or the underlying connection cannot be created.
AdapterException
public WSDefinition(java.lang.String name, java.net.URL wsdlURL, WSModel model, javax.xml.namespace.QName serviceName) throws AdapterException
name
- The name of the data control for which the definition
is being created.wsdlURL
- The URL of the service description.model
- The model representing the Service. The model describes
all the ports and operations exposed by the service
description.serviceName
- The qualified service name for which the definition
is to be intialized. The service description may
describe more that one service. In such a case
the definition is created for the requested service.
{@link
- AdapterException} if the definition for this data
control could be created. This failure may happen if the
WSDL url is invalid and the model cannot be initialized.
or the underlying connection cannot be created.
AdapterException
Method Detail |
---|
public java.lang.String getDCName()
getDCName
in class AbstractDefinition
public WSModel getModel()
public java.net.URL getWSDL()
public java.util.Map getDCOperations()
Map
of the operations for this data controlpublic void setDCOperations(java.util.Map dcOperations)
dcOperations
- The Map
of the operations for this
data controlpublic javax.xml.namespace.QName getServiceName()
public void setServiceName(javax.xml.namespace.QName serviceName)
serviceName
- The Service name for for this definitionpublic java.lang.String getAdapterType()
getAdapterType
in class AbstractDefinition
AdapterDefinition
public SecurityModel getSecurityModel()
public DataControl createDataControl()
createDataControl
in class AbstractDefinition
null
If the data control instance could
not be created.public void loadFromMetadata(Node node, java.util.Map params) throws AdapterException
Node
.
loadFromMetadata
in class AbstractDefinition
node
- the metadata node. It can be null if no metadata is defined.params
- context parameters.
{@link
- AdapterException} if the data control definition
cannot be reconstructed back from the metadata information.
AdapterException
public StructureDefinition getStructure()
getStructure
in interface DataControlDefinition
getStructure
in class AbstractDefinition
StructureDefinition
representing the strcuture
of the data returned by this data control.public void refresh() throws AdapterException
AdapterException
public boolean isStructureDirty(boolean refresh)
refresh
if refresh is requested. If a refresh is needed,
the data control definition recreates the underlying model and connection
to update the metadata of any possible changes to the service operation
signature.
isStructureDirty
in class AbstractDefinition
refresh
- flag to indicate if the refresh is requested for the
structure. If true
, the definition
regenerates the underlying model, operation map and
connection information. This re-generation is needed to
rebuild the structure and make sure that the runtime
has the right connection metadata to execute any modified
operation bindings
true
if the implementation decides that the
structure of the data should be regenerated,
false
otherwise.public Node getMetadata()
The WSDL is parsed to extract as much information as is needed to be stored in the metdata to invoke the service operation at runtime.
getMetadata
in class AbstractDefinition
Node
that defines the metadata for this instance.
This metadata will be used at the runtime to fetch data from the
data source.public java.util.Map getDefaultDCOperations(javax.xml.namespace.QName serviceName) throws AdapterException
serviceName
- The Qualified service Name for which operations
must be fetched.
Map
of Operations for this service.
{@link
- AdapterException} if the service does not exist in
the underlying model.
AdapterException
public void bindServiceConnection(javax.naming.Context context) throws AdapterException
context
- The Context
provided by the caller into which
the connection for this service is to be bound.
{@link
- AdapterException} If the connection cannot be bound into
the context provided.
AdapterException
public boolean isSupported(java.lang.String flag)
AbstractDefinition
isSupported
in class AbstractDefinition
flag
- one of the values defined in
DataControlDefinition
.
public void setRootStructureName(java.lang.String rootDefName)
rootDefName
- The qualified root structure name for this dcpublic java.lang.String getRootStructureName()
protected void destroy() throws AdapterException
Should be invoked by the data control when it is released from an application. The data control definition is voided out once the destroy is invoked. This includes cleaning up of the operations table, purging out the security model and the underlying connection bindings. The definition is not usable anymore once it is destroyed. A new instance of the definition must be created for the dc by loading the definition from the metadata.
AdapterException
- if the definition cannot be destroyed.
|
Oracle Fusion Middleware Java API Reference for Oracle ADF Model 11g Release 1 (11.1.1) E10653-04 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |