public class ApplicationProxy extends DeployedObjectGroupProxy implements DeployedObject, ServiceInterface
Each application deployed to an execution group can be represented by an ApplicationProxy.
In order to use ApplicationProxy objects, applications must first obtain handles to them. Here is an example of how to do this:
BrokerProxy b = BrokerProxy.getInstance( new IntegrationNodeConnectionParameters("localhost", 4414)); ExecutionGroupProxy e = b.getExecutionGroupByName("default"); ApplicationProxy appl = e.getApplicationByName("application1");
com.ibm.broker.config.proxy.ApplicationProxy extends
com.ibm.broker.config.proxy.DeployedObjectGroupProxy implements
com.ibm.broker.config.proxy.DeployedObject
|
|
Responsibilities | Acts as a container of deployed message flows. Provides the ability to deploy information to the application represented by each instance. |
Internal Collaborators | com.ibm.broker.config.proxy.MessageFlowProxy |
Change Activity: -------- ----------- ------------- ------------------------------------ Reason: Date: Originator: Comments: -------- ----------- ------------- ------------------------------------ 80006.1 2011-04-10 HDCAB Initial creation
Modifier and Type | Class and Description |
---|---|
protected class |
ApplicationProxy.ServiceOverview
Inner class to hold service state
The reportproperties structure looks like the following:
Operations
FindAddress
type='RequestResponse'
Components
FindAddress_Request_Response
location='gen/FindAddress_Request_Response.subflow'
type='RequestResponse_Subflow'
SaveAddress
type='RequestResponse'
Components
SaveAddress_Request_Response
location='gen/SaveAddress_Request_Response.subflow'
type='RequestResponse_Subflow'
Implementation
name='gen/AddressBookService.msgflow'
Transports
SOAP
inputNodeLabel='SOAP Input'
url='http://athiri.hursley.ibm.com:7800/jwsAddressBook/AddressBookService'
queryWSDLUrl=''
numberOfFiles='2'
File
name='AddressBook.wsdl'
File
name='AddressBook-0.xsd'
|
Modifier and Type | Field and Description |
---|---|
protected ApplicationProxy.ServiceOverview |
cachedServiceOverview |
protected static java.lang.String |
copyright
IBM Copyright
|
protected static java.lang.String |
sccsid
Version information
|
baseRetryWaitTime, LOCAL_ATTRIBUTE_IDENTIFIER, maxRetries, objectUnavailable, owningPool, potentialNewSubcomponents, propertyUpdateLock, retryWaitTimeIncrement, subcomponentsToBeSubmittedForCreationInCurrentBatch, UUID_DELIMITER
BARNAME_KEYWORD, USAGE_KEYWORD, VERSION_KEYWORD
Modifier | Constructor and Description |
---|---|
protected |
ApplicationProxy(com.ibm.broker.config.proxy.AdministeredObjectPool aop)
DO NOT USE THIS CONSTRUCTOR - use
ExecutionGroupProxy.getApplicationByName(String) instead.
|
Modifier and Type | Method and Description |
---|---|
void |
clearRecordedTestData()
This method clears all recorded test data for the application
|
DeployResult |
deleteDeployedObjects(DeployedObject[] forDeletion,
long timeToWaitMs)
This method overrides the base class
implementation, so that an exception is thrown if this method
is invoked against this class.
|
DeployResult |
deleteDeployedObjectsByName(java.lang.String[] forDeletion,
long timeToWaitMs)
This method overrides the base class
implementation, so that an exception is thrown if this method
is invoked against this class.
|
void |
deploy(java.io.InputStream barStream)
This method overrides the base class
implementation, so that an exception is thrown if this method
is invoked against this class.
|
DeployResult |
deploy(java.io.InputStream barStream,
java.lang.String barFileLabel,
boolean isIncremental,
long timeToWaitMs)
This method overrides the base class
implementation, so that an exception is thrown if this method
is invoked against this class.
|
void |
deploy(java.lang.String barFileName)
This method overrides the base class
implementation, so that an exception is thrown if this method
is invoked against this class.
|
DeployResult |
deploy(java.lang.String barFileName,
boolean isIncremental,
long timeToWaitMs)
This method overrides the base class
implementation, so that an exception is thrown if this method
is invoked against this class.
|
boolean |
fullNameMatches(java.lang.String fileName)
Tests if the name of this deployed object matches the
fileName passed in.
|
protected java.util.Properties |
getAdvancedProperties(boolean waitIfNotUpdated)
Returns a filtered list of the properties table associated with the
current object, removing any basic properties.
|
java.lang.String |
getBARFileName()
Returns the name of the BAR file that was used to deploy
the application to the execution group.
|
protected java.util.Properties |
getBasicProperties(boolean waitIfNotUpdated)
Returns a filtered list of the properties table associated with the
current object, filtered to basic properties only.
|
ConfigurationObjectType |
getConfigurationObjectType()
Returns the ConfigurationObjectType associated
with this AdministeredObject type.
|
ConfigurationObjectType |
getConfigurationObjectTypeOfParent()
Returns the ConfigurationObjectType associated
with the logical parent of this AdministeredObject type.
|
java.util.Properties |
getDeployProperties()
Returns a list of the properties associated with the
deployment of this application.
|
java.util.Date |
getDeployTime()
Returns the time that the current message flow was
last deployed to the execution group.
|
java.util.Vector<java.lang.String> |
getErrorHandlerNames()
Returns a Vector of all the names of the implementation objects
for error handlers for this service.
|
ExecutionGroupProxy |
getExecutionGroup()
Returns a reference to the execution group on
which this application was deployed.
|
java.lang.String |
getFileExtension()
Returns the file extension relevant to applications, not
preceded by a '.' character.
|
java.lang.String |
getFullName()
Returns the name of the current deployable as it
existed in the BAR file at deployment time, including
any file extension but excluding any path information.
|
java.util.Map<java.lang.String,java.lang.String> |
getInterfaceFiles()
Returns a Map of all the WSDL and XSD files for this service.
|
java.util.Map<java.lang.String,java.lang.String> |
getInterfaceFilesAsZip()
Returns a zip of all the WSDL and XSD files for this service.
|
java.lang.String[] |
getKeywords()
Returns the set of keywords for this deployed object
which were found embedded in the object at deploy time.
|
java.lang.String |
getKeywordValue(java.lang.String keyword)
Returns the value of the supplied keyword.
|
java.util.Enumeration<LibraryProxy> |
getLibraries(java.util.Properties filter)
Deprecated.
As of Integration Bus V10, libraries have been
renamed to static libraries. Use getStaticLibraries instead.
|
LibraryProxy |
getLibrary(java.util.Properties props)
Deprecated.
As of Integration Bus V10, libraries have been
renamed to static libraries. Use getStaticLibrary instead.
|
LibraryProxy |
getLibraryByName(java.lang.String libraryName)
Deprecated.
As of Integration Bus V10, libraries have been
renamed to static libraries. Use getStaticLibraryByName instead.
|
MessageFlowProxy |
getMessageFlowByName(java.lang.String messageFlowName,
java.lang.String libraryName)
Returns the MessageFlowProxy object with the supplied name in
the named libary, or null if a flow of that
name does not exist at the given location or if the supplied
messageFlowName argument was null.
|
java.util.Date |
getModifyTime()
Returns the time that the current message flow was
last modified, according to the file modification
associated with the cmf file in the broker archive.
|
java.lang.String |
getRuntimeProperty(java.lang.String objectAndPropertyName)
Returns the value of the runtime property with the supplied name.
|
protected java.lang.String |
getRuntimePropertyFolder()
Returns the runtime property folder for this application type.
|
java.lang.String[] |
getRuntimePropertyNames()
Returns a string array of all runtime configurable service properties
associated with this object.
|
java.lang.String |
getServiceDescriptor()
This method returns the service descriptor
|
protected ApplicationProxy.ServiceOverview |
getServiceInformation() |
java.lang.String |
getServiceName() |
ServiceOperation |
getServiceOperation(java.lang.String operationName)
Returns a ServiceOperation object for a particular operation
for this service.
|
java.util.Enumeration<ServiceOperation> |
getServiceOperations()
Returns an Enumeration of all the ServiceOperation objects
for this service.
|
java.net.URL |
getServiceQueryURL()
Returns the URL for querying the WSDL for the service, if this service has a
binding that uses WSDL (and ?wsdl support is wswitch on for the service)
|
java.net.URL |
getServiceURL()
Returns the URL for the service, if this service has a binding that
can be represented as a URL
|
java.util.Map<SharedLibraryReference,SharedLibraryProxy> |
getSharedLibraryDependencies()
This method returns the shared libraries that this object depends on.
|
java.lang.String |
getStartMode()
Returns the current value of start mode for this application
|
java.util.Enumeration<StaticLibraryProxy> |
getStaticLibraries(java.util.Properties filter)
Returns an Enumeration of all the StaticLibraryProxy objects
that match the filter specified by the Properties argument.
|
StaticLibraryProxy |
getStaticLibrary(java.util.Properties props)
Returns the first StaticLibraryProxy object that matches the
filter specified by the Properties argument.
|
StaticLibraryProxy |
getStaticLibraryByName(java.lang.String staticLibraryName)
Returns the StaticLibraryProxy object with the supplied name,
or null if an static library of that name does not exist or if
the supplied argument was null.
|
java.lang.String |
getVersion()
Returns the version string associated with the current
message flow.
|
boolean |
isJavaIsolated()
Returns the current value of Java isolation for this
application or integration service.
|
boolean |
isRunEnabled()
Returns true only if the application is able to run when the
execution group is started.
|
boolean |
isRunning()
Returns true only if the application is currently running.
|
boolean |
isServiceInternalComponent(java.lang.String objectName)
Returns true if a named resource (a flow, for example) is an
internal piece of the service
|
void |
setAllMessageFlowsRuntimeProperties(java.util.Properties props)
Asks the broker to configure an arbitrary
set of properties of all message flows owned by the application.
|
void |
setAllMessageFlowsRuntimeProperty(java.lang.String objectAndPropertyName,
java.lang.String propertyValue)
Asks the broker to configure an arbitrary
property of all message flows owned by the application.
|
void |
setName(java.lang.String name)
This method overrides the base class
implementation, so that an exception is thrown if this method
is invoked against this class.
|
void |
setRuntimeProperty(java.lang.String objectAndPropertyName,
java.lang.String propertyValue)
Asks the broker to configure an arbitrary application
property.
|
void |
setStartMode(java.lang.String newStartMode)
Configures the start mode setting for the application.
|
void |
start()
Asks the broker to start the execution group process.
|
void |
stop()
Asks the broker to stop the Application.
|
void |
stop(BrokerProxy.StopMode stopMode) |
static java.util.Properties |
withName(java.lang.String name)
Returns a new Properties object that has the name attribute set
to the supplied String, and the type attribute to be the name of
the subclass of AdministeredObject being used.
|
static java.util.Properties |
withUUID(java.lang.String uuid)
Returns a new Properties object that has the UUID attribute set
to the supplied String, and the type attribute to be the name of
the subclass of AdministeredObject being used.
|
deploy, getDeployedObjectByName, getDeployedObjectFromSubcomponentString, getDeployedObjects, getDeployedObjects, getDeployedObjectsCount, getDeployedPolicySetBindingsNames, getDeployedPolicySetNames, getMessageFlow, getMessageFlowByName, getMessageFlowDependencies, getMessageFlows, getMessageSets, getNodeTypes, getQueues, getSubFlow, getSubFlowByName, getSubFlows, setUserTrace, startMessageFlows, stopMessageFlows, stopMessageFlows, stopMessageFlows
checkTypeAndBase64DecodePropertyValue, checkTypeAndBase64EncodePropertyValue, clearPredictedNewSubcomponents, createManagedSubcomponent, createManagedSubcomponent, createManagedSubcomponent, createManagedSubcomponent, deleteManagedSubcomponents, deregisterListener, deregisterListener, elements, equals, execute, getAdvancedProperties, getBasicProperties, getGrandParentUUIDProperties, getLastBIPMessages, getLastCompletionCode, getLastUpdateUser, getLongDescription, getManagedSubcomponent, getManagedSubcomponentFromStringRepresentation, getManagedSubcomponents, getManagedSubcomponents, getManagedSubcomponents, getManagedSubcomponents, getManagedSubcomponentsAsStrings, getManagedSubcomponentsAsStrings, getName, getNumberOfSubcomponents, getParent, getProperties, getProperties, getProperty, getProperty, getProperty, getProperty, getProperty, getPropertyBaseName, getPropertyInt, getPropertyInternal, getRefreshRequired, getRepositoryTimestamp, getShortDescription, getTimeOfLastCompletionCode, getTimeOfLastUpdate, getType, getUUID, getUUIDOfGrandParent, getUUIDOfParent, hasBeenPopulatedByBroker, hasBeenPopulatedByBroker, hasBeenPopulatedByBroker, hasBeenRestrictedByBroker, hasBeenRestrictedByBroker, hasBeenRestrictedByConfigManager, hasBeenRestrictedByConfigManager, hasBeenUpdatedByConfigManager, hasBeenUpdatedByConfigManager, isAUserDefinedObjectDestructor, isAwaitingSubmissionForCreation, isAwaitingSubmissionForDeletion, isDeployed, isLastPropertyIdentifier, isPartOfAPropertyGroup, isShared, predictPropertiesOfNewObject, refresh, refresh, registerListener, registerListener, registerListener, removeLocalProperty, setIsAwaitingSubmissionForCreation, setIsAwaitingSubmissionForDeletion, setLastBIPMessages, setLastCompletionCode, setLocalProperty, setLongDescription, setProperties, setProperties, setRefreshRequired, setShortDescription, setTimeOfLastUpdate, toString, toVerboseString, unsubscribeFromConfigurationManagerUpdates, validateObjectAndPropertyName, validateServiceObjectAndPropertyName
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
getName
protected static final java.lang.String copyright
protected static final java.lang.String sccsid
protected ApplicationProxy.ServiceOverview cachedServiceOverview
protected ApplicationProxy(com.ibm.broker.config.proxy.AdministeredObjectPool aop)
aop
- The pool that will own this object.public boolean isRunning() throws ConfigManagerProxyPropertyNotInitializedException
ConfigManagerProxyPropertyNotInitializedException
- if the value of the run state could not be determined from
the broker.public boolean isRunEnabled() throws ConfigManagerProxyPropertyNotInitializedException
ConfigManagerProxyPropertyNotInitializedException
- if the value of the run state could not be determined from
the broker.public void stop() throws ConfigManagerProxyLoggedException
ConfigManagerProxyLoggedException
- if the request could not be
sent to the broker. If synchronous updates have been enabled using
BrokerProxy.setSynchronous(), subclasses of this exception type will
also be thrown if the request is rejected by the broker, or if the
request is not processed before a timeout occurs.public void stop(BrokerProxy.StopMode stopMode) throws ConfigManagerProxyLoggedException
public void start() throws ConfigManagerProxyLoggedException
ConfigManagerProxyLoggedException
- if the request could not be
sent to the broker. If synchronous updates have been enabled using
BrokerProxy.setSynchronous(), subclasses of this exception type will
also be thrown if the request is rejected by the broker, or if the
request is not processed before a timeout occurs.public java.lang.String getStartMode() throws ConfigManagerProxyPropertyNotInitializedException
ConfigManagerProxyPropertyNotInitializedException
- if the value of the field could not be determined because
the value has not yet been supplied to from the broker.public void setStartMode(java.lang.String newStartMode) throws ConfigManagerProxyLoggedException
Configures the start mode setting for the application.
newStartMode
- One of:
ConfigManagerProxyLoggedException
public boolean isJavaIsolated() throws ConfigManagerProxyPropertyNotInitializedException
ConfigManagerProxyPropertyNotInitializedException
- if the value of the field could not be determined because
the value has not yet been supplied to from the broker.public void clearRecordedTestData() throws ConfigManagerProxyPropertyNotInitializedException
public static java.util.Properties withUUID(java.lang.String uuid)
public static java.util.Properties withName(java.lang.String name)
public ConfigurationObjectType getConfigurationObjectType()
getConfigurationObjectType
in class DeployedObjectGroupProxy
public ConfigurationObjectType getConfigurationObjectTypeOfParent()
getConfigurationObjectTypeOfParent
in class DeployedObjectGroupProxy
public void setAllMessageFlowsRuntimeProperty(java.lang.String objectAndPropertyName, java.lang.String propertyValue) throws ConfigManagerProxyLoggedException, java.lang.IllegalArgumentException
Constants exist for many common objectAndPropertyName values in the AttributeConstants interface, and you should use these wherever possible.
The list of currently defined property names can be obtained using the method getRuntimePropertyNames(). However, not all runtime properties returned by this method can be set.
setAllMessageFlowsRuntimeProperty
in class DeployedObjectGroupProxy
objectAndPropertyName
- The complete object and property name of the
property being manipulatedpropertyValue
- The new value to associate with the propertyConfigManagerProxyLoggedException
- if the request could not be
sent to the broker. If synchronous updates have been enabled using
BrokerProxy.setSynchronous(), subclasses of this exception type will
also be thrown if the request is rejected by the broker, or if the
request is not processed before a timeout occurs.java.lang.IllegalArgumentException
- if objectAndPropertyName is not a valid syntax.public void setAllMessageFlowsRuntimeProperties(java.util.Properties props) throws ConfigManagerProxyLoggedException, java.lang.IllegalArgumentException
Constants exist for many common objectAndPropertyName values in the AttributeConstants interface, and you should use these wherever possible.
The list of currently defined property names can be obtained using the method getRuntimePropertyNames(). However, not all runtime properties returned by this method can be set.
setAllMessageFlowsRuntimeProperties
in class DeployedObjectGroupProxy
props
- A set of properties to set on all message flows owned by the application.
The key is the complete object and property name of the property being manipulated.
The value is the new value to associate with the propertyConfigManagerProxyLoggedException
- if the request could not be
sent to the broker. If synchronous updates have been enabled using
BrokerProxy.setSynchronous(), subclasses of this exception type will
also be thrown if the request is rejected by the broker, or if the
request is not processed before a timeout occurs.java.lang.IllegalArgumentException
- if objectAndPropertyName is not a valid syntax.public void setRuntimeProperty(java.lang.String objectAndPropertyName, java.lang.String propertyValue) throws ConfigManagerProxyLoggedException, java.lang.IllegalArgumentException
Constants exist for many common objectAndPropertyName values in the AttributeConstants interface, and you should use these wherever possible.
The list of currently defined property names can be obtained using the method getRuntimePropertyNames(). However, not all runtime properties returned by this method can be set.
objectAndPropertyName
- The complete object and property name of the
property being manipulatedpropertyValue
- The new value to associate with the propertyConfigManagerProxyLoggedException
- if the request could not be
sent to the broker. If synchronous updates have been enabled using
BrokerProxy.setSynchronous(), subclasses of this exception type will
also be thrown if the request is rejected by the broker, or if the
request is not processed before a timeout occurs.java.lang.IllegalArgumentException
- if objectAndPropertyName is not of a valid syntax.public java.lang.String[] getRuntimePropertyNames()
public java.lang.String getRuntimeProperty(java.lang.String objectAndPropertyName) throws ConfigManagerProxyPropertyNotInitializedException, java.lang.IllegalArgumentException
If you wish to directly look up a specific named property, use constants defined in the AttributeConstants interface wherever possible. If a constant does not exist, the objectAndpropertyName parameter can be made up of a String of the form "ObjectName/PropertyName", where ObjectName and PropertyName are the object and property names supplied on the -o and -n parameters respectively of mqsireportproperties. The '/' separator is defined as AttributeConstants.OBJECT_NAME_DELIMITER.
objectAndPropertyName
- The name of the property to be reportedConfigManagerProxyPropertyNotInitializedException
- if the value of the property could not be determined because
the information was not supplied from the broker before a
timeout occurred.java.lang.IllegalArgumentException
- if objectAndPropertyName is not a valid syntax.public java.util.Properties getDeployProperties() throws ConfigManagerProxyPropertyNotInitializedException
This method will pause until the object has received at least one update from the broker. If an update is not received before the timeout specified in BrokerProxy.setRetryCharacteristics() is reached, AdministeredObject.hasBeenPopulatedByBroker() will return false and the returned Properties object will be null.
getDeployProperties
in interface DeployedObject
ConfigManagerProxyPropertyNotInitializedException
public ExecutionGroupProxy getExecutionGroup() throws ConfigManagerProxyLoggedException
getExecutionGroup
in interface DeployedObject
ConfigManagerProxyLoggedException
- if the parent
object is not immediately available and has to be
requested from the broker, but the
request could not be sent to the broker.DeployedObject.getExecutionGroup()
public java.lang.String getBARFileName() throws ConfigManagerProxyPropertyNotInitializedException
getBARFileName
in interface DeployedObject
ConfigManagerProxyPropertyNotInitializedException
- if the value of the parameter could not be determined because
the information was not supplied from the broker before a
timeout occurred.public java.lang.String[] getKeywords() throws ConfigManagerProxyPropertyNotInitializedException
See the DeployedObject class for an overview of how to associate keywords with deployed objects.
getKeywords
in interface DeployableObject
ConfigManagerProxyPropertyNotInitializedException
- if the value of the parameter could not be determined because
the information was not supplied from the broker before a
timeout occurred.DeployableObject.getKeywords()
public java.lang.String getKeywordValue(java.lang.String keyword) throws ConfigManagerProxyPropertyNotInitializedException
See the DeployedObject class for an overview of how to associate keywords with deployed objects.
getKeywordValue
in interface DeployableObject
keyword
- The keyword to look upConfigManagerProxyPropertyNotInitializedException
- if the value of the parameter could not be determined because
the information was not supplied from the broker before a
timeout occurred.DeployableObject.getKeywordValue(java.lang.String)
public java.lang.String getVersion() throws ConfigManagerProxyPropertyNotInitializedException
getVersion
in interface DeployableObject
ConfigManagerProxyNotInitializedException
- if the value of the parameter could not be determined because
the information was not supplied from the broker before a
timeout occurred.ConfigManagerProxyPropertyNotInitializedException
- if the value of the parameter could not be determined because
the information was not supplied from the broker before a
timeout occurred.DeployableObject.getVersion()
public java.util.Date getDeployTime()
getDeployTime
in interface DeployedObject
DeployedObject.getDeployTime()
public java.util.Date getModifyTime()
getModifyTime
in interface DeployableObject
DeployableObject.getModifyTime()
public java.lang.String getFileExtension()
getFileExtension
in interface DeployableObject
DeployableObject.getFileExtension()
public java.lang.String getFullName() throws ConfigManagerProxyPropertyNotInitializedException
getFullName
in interface DeployableObject
ConfigManagerProxyPropertyNotInitializedException
- if the value of the parameter could not be determined because
the information was not supplied from the broker before a
timeout occurred.public java.lang.String getServiceName()
getServiceName
in interface com.ibm.broker.config.common.CommonServiceInterface
public boolean fullNameMatches(java.lang.String fileName) throws ConfigManagerProxyPropertyNotInitializedException
fullNameMatches
in interface DeployedObject
ConfigManagerProxyLoggedException
- if the parent
object is not immediately available and has to be
requested from the broker, but the
request could not be sent to the broker.ConfigManagerProxyPropertyNotInitializedException
@Deprecated public java.util.Enumeration<LibraryProxy> getLibraries(java.util.Properties filter) throws ConfigManagerProxyPropertyNotInitializedException
filter
- Filter to select which libraries to return.
Each key is an attribute name of the required object
and each value is the required value of the attribute. A null or
empty Properties object will match all libraries deployed
to this application.ConfigManagerProxyPropertyNotInitializedException
- if library information could not be determined because
the information was not supplied from the broker before a
timeout occurred.AttributeConstants
@Deprecated public LibraryProxy getLibrary(java.util.Properties props) throws ConfigManagerProxyPropertyNotInitializedException
props
- Filter to select the LibraryProxy
Each key is an attribute name of the required object
and each value is the required value of the attribute. A null or
empty Properties object will match an arbitrary library
deployed to this application.ConfigManagerProxyPropertyNotInitializedException
- if library information could not be determined because
the information was not supplied from the broker before a
timeout occurred.@Deprecated public LibraryProxy getLibraryByName(java.lang.String libraryName) throws ConfigManagerProxyPropertyNotInitializedException
libraryName
- Name of the library to look upConfigManagerProxyPropertyNotInitializedException
- if library information could not be determined because the
information was not supplied from the broker before a timeout
occurred.public java.util.Enumeration<StaticLibraryProxy> getStaticLibraries(java.util.Properties filter) throws ConfigManagerProxyPropertyNotInitializedException
filter
- Filter to select which static libraries to return.
Each key is an attribute name of the required object
and each value is the required value of the attribute. A null or
empty Properties object will match all static libraries deployed
to this application.ConfigManagerProxyPropertyNotInitializedException
- if static library information could not be determined because
the information was not supplied from the broker before a
timeout occurred.AttributeConstants
public StaticLibraryProxy getStaticLibrary(java.util.Properties props) throws ConfigManagerProxyPropertyNotInitializedException
props
- Filter to select the StaticLibraryProxy
Each key is an attribute name of the required object
and each value is the required value of the attribute. A null or
empty Properties object will match an arbitrary static library
deployed to this application.ConfigManagerProxyPropertyNotInitializedException
- if static library information could not be determined because
the information was not supplied from the broker before a
timeout occurred.public StaticLibraryProxy getStaticLibraryByName(java.lang.String staticLibraryName) throws ConfigManagerProxyPropertyNotInitializedException
staticLibraryName
- Name of the static library to look upConfigManagerProxyPropertyNotInitializedException
- if static library information could not be determined because the
information was not supplied from the broker before a timeout
occurred.public MessageFlowProxy getMessageFlowByName(java.lang.String messageFlowName, java.lang.String libraryName) throws ConfigManagerProxyPropertyNotInitializedException
messageFlowName
- Name of the message flow to look uplibraryName
- Name of the library in which to look
for the flow, or null if the flow is not
in a libraryConfigManagerProxyPropertyNotInitializedException
- if message flow information could not be determined because
the information was not supplied from the broker before a
timeout occurred.public void setName(java.lang.String name) throws ConfigManagerProxyLoggedException
setName
in class AdministeredObject
name
- (this is ignored)ConfigManagerProxyLoggedException
- to indicate this
method should not be called.public DeployResult deploy(java.lang.String barFileName, boolean isIncremental, long timeToWaitMs) throws ConfigManagerProxyLoggedException, java.io.IOException
deploy
in class DeployedObjectGroupProxy
barFileName
- Path and file name of the Bar file,
relative to the current directory.isIncremental
- If true, the contents of the Bar
file will add or modify what has already been
deployed on the execution group.
If false, the contents of the execution group will
be completely cleared before deployment (also known
as a "complete" deploy).timeToWaitMs
- A positive value describes the
maximum length of time to wait for broker responses
(in milliseconds) before returning the DeployResult.
Alternatively:
ConfigManagerProxyLoggedException
- to indicate this
method should not be called.java.io.FileNotFoundException
- if the Bar file could not be foundjava.io.IOException
- if the file could not be closed.
In this case the deployment might have succeeded.public DeployResult deploy(java.io.InputStream barStream, java.lang.String barFileLabel, boolean isIncremental, long timeToWaitMs) throws ConfigManagerProxyLoggedException
deploy
in class DeployedObjectGroupProxy
barStream
- InputStream containing the BAR file
contents. The first byte read by the stream must be the
first byte of the Bar file's contents.barFileLabel
- the name of the Bar file being
deployed. Every DeployedObject that results from
this deployment will return this value (which may be null)
from the getBARFileName() method.isIncremental
- If true, the contents of the Bar
file will add or modify what has already been
deployed on the execution group.
If false, the contents of the execution group will
be completely cleared before deployment (also known
as a "complete" deploy).timeToWaitMs
- A positive value describes the
maximum length of time to wait for broker responses
(in milliseconds) before returning the DeployResult.
Alternatively:
ConfigManagerProxyLoggedException
- to indicate this
method should not be called.public void deploy(java.lang.String barFileName) throws ConfigManagerProxyLoggedException, java.io.IOException
deploy
in class DeployedObjectGroupProxy
barFileName
- Path and file name of the Bar file,
relative to the current directory.ConfigManagerProxyLoggedException
- to indicate this
method should not be called.java.io.FileNotFoundException
- if the Bar file could not be foundjava.io.IOException
- if the file could not be closed.
In this case the deployment might have succeeded.public void deploy(java.io.InputStream barStream) throws ConfigManagerProxyLoggedException
deploy
in class DeployedObjectGroupProxy
barStream
- InputStream containing the Bar file contents.
The first byte read by the stream must be the
first byte of the Bar file's contents.ConfigManagerProxyLoggedException
- to indicate this
method should not be called.public DeployResult deleteDeployedObjects(DeployedObject[] forDeletion, long timeToWaitMs) throws ConfigManagerProxyLoggedException
deleteDeployedObjects
in class DeployedObjectGroupProxy
forDeletion
- representing the DeployedObject objects
that require deletion (e.g. message flows, message sets).
If the value is null or empty, this method does nothing.
If an element in the array is null, the element is ignored.timeToWaitMs
- A positive value describes the
maximum length of time to wait for broker responses
(in milliseconds) before returning the DeployResult.
Alternatively:
ConfigManagerProxyLoggedException
- to indicate this
method should not be called.public DeployResult deleteDeployedObjectsByName(java.lang.String[] forDeletion, long timeToWaitMs) throws ConfigManagerProxyLoggedException, ConfigManagerProxyPropertyNotInitializedException
deleteDeployedObjectsByName
in class DeployedObjectGroupProxy
forDeletion
- An array of Strings, with each element
being the name (e.g. "mf1") or fullname (e.g. "mf1.cmf")
of an object that is to be removed from the execution group.
If the array is null or empty, this method does nothing.
If an element in the array is null, the element is ignored.timeToWaitMs
- A positive value describes the
maximum length of time to wait for broker responses
(in milliseconds) before returning the DeployResult.
Alternatively:
ConfigManagerProxyLoggedException
- to indicate this
method should not be called.ConfigManagerProxyPropertyNotInitializedException
- if deployed object information could not be determined because
the information was not supplied from the broker before a
timeout occurred.public java.lang.String getServiceDescriptor() throws ConfigManagerProxyPropertyNotInitializedException
getServiceDescriptor
in interface ServiceInterface
ConfigManagerProxyLoggedException
- to indicate this
method should not be called.ConfigManagerProxyPropertyNotInitializedException
protected ApplicationProxy.ServiceOverview getServiceInformation() throws ConfigManagerProxyPropertyNotInitializedException, ConfigManagerProxyLoggedException
public java.util.Vector<java.lang.String> getErrorHandlerNames() throws ConfigManagerProxyPropertyNotInitializedException, ConfigManagerProxyLoggedException
getErrorHandlerNames
in interface ServiceInterface
ConfigManagerProxyPropertyNotInitializedException
- if operation information could not be determined because
the information was not supplied from the broker before a
timeout occurred.ConfigManagerProxyLoggedException
public ServiceOperation getServiceOperation(java.lang.String operationName) throws ConfigManagerProxyPropertyNotInitializedException, ConfigManagerProxyLoggedException
getServiceOperation
in interface ServiceInterface
ConfigManagerProxyPropertyNotInitializedException
- if operation information could not be determined because
the information was not supplied from the broker before a
timeout occurred.ConfigManagerProxyLoggedException
public java.util.Enumeration<ServiceOperation> getServiceOperations() throws ConfigManagerProxyPropertyNotInitializedException, ConfigManagerProxyLoggedException
getServiceOperations
in interface ServiceInterface
ConfigManagerProxyPropertyNotInitializedException
- if operation information could not be determined because
the information was not supplied from the broker before a
timeout occurred.ConfigManagerProxyLoggedException
AttributeConstants
public boolean isServiceInternalComponent(java.lang.String objectName) throws ConfigManagerProxyPropertyNotInitializedException, ConfigManagerProxyLoggedException
isServiceInternalComponent
in interface ServiceInterface
objectName
- Name of object to checkConfigManagerProxyLoggedException
ConfigManagerProxyPropertyNotInitializedException
public java.net.URL getServiceURL() throws ConfigManagerProxyPropertyNotInitializedException, ConfigManagerProxyLoggedException
getServiceURL
in interface ServiceInterface
ConfigManagerProxyPropertyNotInitializedException
- if operation information could not be determined because
the information was not supplied from the broker before a
timeout occurred.ConfigManagerProxyLoggedException
public java.net.URL getServiceQueryURL() throws ConfigManagerProxyPropertyNotInitializedException, ConfigManagerProxyLoggedException
getServiceQueryURL
in interface ServiceInterface
ConfigManagerProxyPropertyNotInitializedException
- if operation information could not be determined because
the information was not supplied from the broker before a
timeout occurred.ConfigManagerProxyLoggedException
public java.util.Map<java.lang.String,java.lang.String> getInterfaceFiles() throws ConfigManagerProxyPropertyNotInitializedException
getInterfaceFiles
in interface ServiceInterface
ConfigManagerProxyPropertyNotInitializedException
- if operation information could not be determined because
the information was not supplied from the broker before a
timeout occurred.public java.util.Map<java.lang.String,java.lang.String> getInterfaceFilesAsZip() throws ConfigManagerProxyPropertyNotInitializedException
getInterfaceFilesAsZip
in interface ServiceInterface
ConfigManagerProxyPropertyNotInitializedException
- if operation information could not be determined because
the information was not supplied from the broker before a
timeout occurred.protected java.util.Properties getBasicProperties(boolean waitIfNotUpdated) throws ConfigManagerProxyPropertyNotInitializedException
This method will pause until the object has received at least one update from the broker. If an update is not received before the timeout specified in BrokerProxy.setRetryCharacteristics() is reached, AdministeredObject.hasBeenPopulatedByBroker() will return false and the returned Properties object will contain a much smaller set of properties, that the IBM Integration API (CMP) has derived from other sources.
getBasicProperties
in class AdministeredObject
waitIfNotUpdated
- Only if this value is true, the method
will pause until the object has received at least one update from
the broker. If an update is not received before the timeout specified
in BrokerProxy.setRetryCharacteristics() is reached,
AdministeredObject.hasBeenPopulatedByBroker() will return false and the returned
Properties object will contain a much smaller set of properties,
that the IBM Integration API (CMP) has derived from other
sources.ConfigManagerProxyPropertyNotInitializedException
protected java.util.Properties getAdvancedProperties(boolean waitIfNotUpdated) throws ConfigManagerProxyPropertyNotInitializedException
getAdvancedProperties
in class AdministeredObject
waitIfNotUpdated
- Only if this value is true, the method
will pause until the object has received at least one update from
the broker. If an update is not received before the timeout specified
in BrokerProxy.setRetryCharacteristics() is reached,
AdministeredObject.hasBeenPopulatedByBroker() will return false and the returned
Properties object will contain a much smaller set of properties,
that the IBM Integration API (CMP) has derived from other
sources.ConfigManagerProxyPropertyNotInitializedException
public java.util.Map<SharedLibraryReference,SharedLibraryProxy> getSharedLibraryDependencies() throws ConfigManagerProxyLoggedException, ConfigManagerProxyPropertyNotInitializedException
ConfigManagerProxyPropertyNotInitializedException
- if the value of the parameter could not be determined because
the information was not supplied from the broker before a
timeout occurred.ConfigManagerProxyLoggedException
- to indicate a problem
with retrieving the information.protected java.lang.String getRuntimePropertyFolder()