01: /*
02: * BEGIN_HEADER - DO NOT EDIT
03: *
04: * The contents of this file are subject to the terms
05: * of the Common Development and Distribution License
06: * (the "License"). You may not use this file except
07: * in compliance with the License.
08: *
09: * You can obtain a copy of the license at
10: * https://open-esb.dev.java.net/public/CDDLv1.0.html.
11: * See the License for the specific language governing
12: * permissions and limitations under the License.
13: *
14: * When distributing Covered Code, include this CDDL
15: * HEADER in each file and include the License file at
16: * https://open-esb.dev.java.net/public/CDDLv1.0.html.
17: * If applicable add the following below this CDDL HEADER,
18: * with the fields enclosed by brackets "[]" replaced with
19: * your own identifying information: Portions Copyright
20: * [year] [name of copyright owner]
21: */
22:
23: /*
24: * @(#)ServiceUnitRegistration.java
25: * Copyright 2004-2007 Sun Microsystems, Inc. All Rights Reserved.
26: *
27: * END_HEADER - DO NOT EDIT
28: */
29: package com.sun.jbi;
30:
31: /**
32: * This interface provides services for registration/unregistration/query of
33: * Service Units.
34: *
35: * @author Sun Microsystems, Inc.
36: */
37: public interface ServiceUnitRegistration {
38: /**
39: * Check to see if a Service Unit with the specified name is registered
40: * to the Component with the specified name.
41: * @param componentName The unique Component name.
42: * @param serviceUnitName The unique Service Unit name.
43: * @return true if the name is registered, false if not.
44: * @throws javax.jbi.JBIException if no Component exists with the specified
45: * component name.
46: */
47: boolean isServiceUnitRegistered(String componentName,
48: String serviceUnitName) throws javax.jbi.JBIException;
49:
50: /**
51: * Register a Service Unit that has been deployed to a particular BC or
52: * SE. This is done after a successful deployment operation.
53: * @param componentName The unique name of the BC or SE.
54: * @param serviceAssemblyName The unique name of the Service Assembly.
55: * @param serviceUnitName The unique name of the Service Unit.
56: * @param serviceUnitFilePath The fully-qualified path to the Service Unit
57: * deployment descriptor.
58: * @throws javax.jbi.JBIException if no Component exists with the specified
59: * component name or if there is already a Service Unit with the specified
60: * service unit name registered to the component.
61: */
62: void registerServiceUnit(String componentName,
63: String serviceAssemblyName, String serviceUnitName,
64: String serviceUnitFilePath) throws javax.jbi.JBIException;
65:
66: /**
67: * Unregister a Service Unit that has been undeployed from a particular BC
68: * or SE. This is done after a successful undeployment operation.
69: * @param componentName The unique name of the BC or SE.
70: * @param serviceUnitName The unique name of the Service Unit.
71: * @throws javax.jbi.JBIException if no Component exists with the specified
72: * component name or if there is no Service Unit with the specified
73: * service unit name registered to the component.
74: */
75: void unregisterServiceUnit(String componentName,
76: String serviceUnitName) throws javax.jbi.JBIException;
77: }
|