diff options
Diffstat (limited to 'sca-java-1.x/tags/java-stable-20060304/spec/sca/src/main/java/org/osoa/sca/ModuleContext.java')
-rw-r--r-- | sca-java-1.x/tags/java-stable-20060304/spec/sca/src/main/java/org/osoa/sca/ModuleContext.java | 85 |
1 files changed, 85 insertions, 0 deletions
diff --git a/sca-java-1.x/tags/java-stable-20060304/spec/sca/src/main/java/org/osoa/sca/ModuleContext.java b/sca-java-1.x/tags/java-stable-20060304/spec/sca/src/main/java/org/osoa/sca/ModuleContext.java new file mode 100644 index 0000000000..e48235be3b --- /dev/null +++ b/sca-java-1.x/tags/java-stable-20060304/spec/sca/src/main/java/org/osoa/sca/ModuleContext.java @@ -0,0 +1,85 @@ +/** + * + * Copyright 2005 The Apache Software Foundation or its licensors, as applicable. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.osoa.sca; + + +/** + * @version $Rev$ $Date$ + */ +public interface ModuleContext { + + /** + * Returns the name of the module. + * + * @return the name of the module + */ + String getName(); + + /** + * Returns the absolute URI of the module component. + * + * @return the absolute URI of the module component + */ + String getURI(); + +//FIXME This is not implemented yet, we need the SCA spec to define the metadata model first. +// /** +// * Returns the Module metadata object. +// * This represents the root <module> element in the SCA module definition. +// * +// * @return the module metadata object +// */ +// Module getMetaData(); + + /** + * Returns the request context that corresponds to the last remotable service invocation. + * If this is invoked from outside an SCA component then <tt>null</tt> is returned. + * + * @return the current request context + */ + RequestContext getRequestContext(); + + /** + * Returns an object implementing the interface defined for the named service. + * + * @param serviceName the name of another service in the current module + * @return an object that implements the service's interface + */ + Object locateService(String serviceName); + + /** + * Create a reference to the supplied component. + * The component must define only one service. + * + * @param self the component to be referenced + * @return a reference to the component + */ + ServiceReference createServiceReferenceForSession(Object self); + + /** + * Create a reference to the named service implemented by the supplied component. + * + * @param self the component to be referenced + * @param serviceName the service to be referenced + * @return a reference to the service + */ + ServiceReference createServiceReferenceForSession(Object self, String serviceName); + + ServiceReference newSession(String serviceName); + + ServiceReference newSession(String serviceName, Object sessionId); +} |