001: /*
002: * BEGIN_HEADER - DO NOT EDIT
003: *
004: * The contents of this file are subject to the terms
005: * of the Common Development and Distribution License
006: * (the "License"). You may not use this file except
007: * in compliance with the License.
008: *
009: * You can obtain a copy of the license at
010: * https://open-esb.dev.java.net/public/CDDLv1.0.html.
011: * See the License for the specific language governing
012: * permissions and limitations under the License.
013: *
014: * When distributing Covered Code, include this CDDL
015: * HEADER in each file and include the License file at
016: * https://open-esb.dev.java.net/public/CDDLv1.0.html.
017: * If applicable add the following below this CDDL HEADER,
018: * with the fields enclosed by brackets "[]" replaced with
019: * your own identifying information: Portions Copyright
020: * [year] [name of copyright owner]
021: */
022:
023: /*
024: * @(#)ScaffoldRegistry.java
025: * Copyright 2004-2007 Sun Microsystems, Inc. All Rights Reserved.
026: *
027: * END_HEADER - DO NOT EDIT
028: */
029: /**
030: * ScaffoldRegistry.java
031: *
032: * SUN PROPRIETARY/CONFIDENTIAL.
033: * This software is the proprietary information of Sun Microsystems, Inc.
034: * Use is subject to license terms.
035: *
036: * Created on November 8, 2006, 5:17 PM
037: */package com.sun.jbi.framework;
038:
039: import com.sun.jbi.ComponentInfo;
040: import com.sun.jbi.ComponentQuery;
041: import com.sun.jbi.ComponentState;
042: import com.sun.jbi.ComponentType;
043: import com.sun.jbi.ServiceAssemblyInfo;
044: import com.sun.jbi.ServiceAssemblyQuery;
045: import com.sun.jbi.ServiceAssemblyState;
046: import com.sun.jbi.ServiceUnitInfo;
047: import com.sun.jbi.ServiceUnitState;
048:
049: import com.sun.jbi.management.ConfigurationCategory;
050: import com.sun.jbi.management.registry.RegistryException;
051:
052: import java.io.ByteArrayInputStream;
053:
054: import java.util.ArrayList;
055: import java.util.Calendar;
056: import java.util.HashMap;
057: import java.util.Iterator;
058: import java.util.List;
059: import java.util.Properties;
060: import java.util.Map;
061:
062: /**
063: * Scaffolded registry implementation to allow unit testing of the framework.
064: *
065: * @author Sun Microsystems, Inc.
066: */
067: public class ScaffoldRegistry implements
068: com.sun.jbi.management.registry.Registry,
069: com.sun.jbi.management.registry.Updater,
070: com.sun.jbi.ComponentQuery {
071: /**
072: * EnvironmentContext handle.
073: */
074: EnvironmentContext mContext;
075:
076: /**
077: * ComponentRegistry handle.
078: */
079: ComponentRegistry mCompReg;
080:
081: /**
082: * Constructor.
083: *
084: * @param the instance of the EnvironmentContext for testing.
085: */
086: ScaffoldRegistry(EnvironmentContext context) {
087: mContext = context;
088: mCompReg = mContext.getComponentRegistry();
089: }
090:
091: ///////////////////////////////////////////////////////////////////////////////
092: //
093: // Methods from the Registry interface
094: //
095: ///////////////////////////////////////////////////////////////////////////////
096:
097: /**
098: * Get the Updater instance to be used for updating the Registry.
099: *
100: * @return an instance of the Updater to be used to manipulate
101: * ( create / delete / modify ) contents of the registry.
102: * @throws RegistryException if problems are encountered in creating
103: * a Updater.
104: */
105: public com.sun.jbi.management.registry.Updater getUpdater()
106: throws RegistryException {
107: return this ;
108: }
109:
110: /**
111: * Get a Generic Query Instance.
112: * @return an instance of GenericQuery.
113: * @throws RegistryException on errors.
114: */
115: public com.sun.jbi.management.registry.GenericQuery getGenericQuery()
116: throws RegistryException {
117: return null;
118: }
119:
120: /**
121: * Get a ComponentQuery instance for a given target.
122: *
123: * @param targetName the name identifying the target.
124: * @return an instance of ComponentQuery.
125: * @throws RegistryException on errors.
126: */
127: public ComponentQuery getComponentQuery(String targetName)
128: throws RegistryException {
129: return null;
130: }
131:
132: /**
133: * Get the ComponentQuery specific to the target of the instance.
134: * @return an instance of ComponentQuery.
135: * @throws RegistryException on errors.
136: */
137: public ComponentQuery getComponentQuery() throws RegistryException {
138: return this ;
139: }
140:
141: /**
142: * Get a ServiceAssemblyQuery instance for a given target
143: *
144: * @param targetName the name identifying the target.
145: * @return an instance of ServiceAssemblyQuery.
146: * @throws RegistryException on errors.
147: */
148: public ServiceAssemblyQuery getServiceAssemblyQuery(
149: String targetName) throws RegistryException {
150: return null;
151: }
152:
153: /**
154: * Get the ServiceAssemblyQuery specific to the target of the instance.
155: * @return an instance of ServiceAssemblyQuery.
156: * @throws RegistryException on errors.
157: */
158: public ServiceAssemblyQuery getServiceAssemblyQuery()
159: throws RegistryException {
160: return null;
161: }
162:
163: /**
164: * destroy the single instance.
165: */
166: public void destroy() {
167: }
168:
169: /**
170: * Get the Registry Specification.
171: */
172: public com.sun.jbi.management.registry.RegistrySpec getRegistrySpec() {
173: return null;
174: }
175:
176: /**
177: * Get the Repository the registry instance uses.
178: */
179: public com.sun.jbi.management.repository.Repository getRepository() {
180: return null;
181: }
182:
183: /**
184: * Get a registry property.
185: */
186: public String getProperty(String propName) {
187: return propName;
188: }
189:
190: /**
191: * Commit the changes to the registry.
192: */
193: public void commit() throws RegistryException {
194: }
195:
196: /**
197: * Commit the changes to the registry.
198: */
199: public ByteArrayInputStream snapshot() throws RegistryException {
200: return (null);
201: }
202:
203: ///////////////////////////////////////////////////////////////////////////////
204: //
205: // Methods from the Updater interface
206: //
207: ///////////////////////////////////////////////////////////////////////////////
208:
209: /**
210: * Add a component to the runtime target.
211: *
212: * @param componentInfo the component instance
213: * @throws RegistryException on errors
214: */
215: public void addComponent(ComponentInfo componentInfo)
216: throws RegistryException {
217: }
218:
219: /**
220: * Add a component to a given target.
221: *
222: * @param targetName {'domain', 'server', "instance-name", "cluster-name"}
223: * @param componentInfo the component instance
224: * @throws RegistryException on errors
225: */
226: public void addComponent(String targetName,
227: ComponentInfo componentInfo) throws RegistryException {
228: }
229:
230: /**
231: * Remove a component from the runtime's target.
232: *
233: * @param componentName the component name
234: * @throws RegistryException on errors
235: */
236: public void removeComponent(String componentName)
237: throws RegistryException {
238: }
239:
240: /**
241: * Remove a component from a given target.
242: *
243: * @param targetName {'domain', 'server', "instance-name", "cluster-name"}
244: * @param componentName the component name
245: * @throws RegistryException on errors
246: */
247: public void removeComponent(String targetName, String componentName)
248: throws RegistryException {
249: }
250:
251: /**
252: * Add a shared library to the runtime's target.
253: *
254: * @param ComponentInfo the shared library instance
255: * @throws RegistryException on errors
256: */
257: public void addSharedLibrary(ComponentInfo sharedLibraryInfo)
258: throws RegistryException {
259: }
260:
261: /**
262: * Add a shared library to a given target. If target = DOMAIN, then a simple
263: * entry is created with the library name. If the target = SERVER / CLUSTER
264: * a shared-library-ref is added.
265: *
266: * @param targetName {'domain', 'server', "instance-name", "cluster-name"}
267: * @param ComponentInfo the shared library instance
268: * @throws RegistryException on errors
269: */
270: public void addSharedLibrary(String targetName,
271: ComponentInfo sharedLibraryInfo) throws RegistryException {
272: }
273:
274: /**
275: * Remove a shared library from the runtime's target
276: *
277: * @param sharedLibraryName the shared library name
278: * @throws RegistryException on errors
279: */
280: public void removeSharedLibrary(String sharedLibraryName)
281: throws RegistryException {
282: }
283:
284: /**
285: * Remove a shared library from a given target.
286: *
287: * @param targetName {'domain', 'server', "instance-name", "cluster-name"}
288: * @param sharedLibraryName the shared library name
289: * @throws RegistryException on errors
290: */
291: public void removeSharedLibrary(String targetName,
292: String sharedLibraryName) throws RegistryException {
293: }
294:
295: /**
296: * Remove a service assembly from a given target.
297: *
298: * @param serviceAssemblyName the service assembly name
299: * @throws RegistryException on errors
300: */
301: public void removeServiceAssembly(String serviceAssemblyName)
302: throws RegistryException {
303: }
304:
305: /**
306: * Remove a service assembly from a given target.
307: *
308: * @param serviceAssemblyName - service assembly name
309: * @param targetName - {'domain', 'server', "instance-name", "cluster-name"}
310: * @throws RegistryException on errors
311: */
312: public void removeServiceAssembly(String targetName,
313: String serviceAssemblyName) throws RegistryException {
314: }
315:
316: /**
317: * Add a server name.
318: *
319: * @param serverNameRef the server name to be added
320: * @throws RegistryException on errors
321: */
322: public void addServer(String serverNameRef)
323: throws RegistryException {
324: }
325:
326: /**
327: * Remove a server name.
328: *
329: * @param serverNameRef the server name to be removed
330: * @throws RegistryException on errors
331: */
332: public void removeServer(String serverNameRef)
333: throws RegistryException {
334: }
335:
336: /**
337: * Add a cluster name.
338: *
339: * @param clusterNameRef the cluster name to be added
340: * @throws RegistryException on errors
341: */
342: public void addCluster(String clusterNameRef)
343: throws RegistryException {
344: }
345:
346: /**
347: * Remove a cluster name.
348: *
349: * @param clusterNameRef the cluster name to be removed
350: * @throws RegistryException on errors
351: */
352: public void removeCluster(String clusterNameRef)
353: throws RegistryException {
354: }
355:
356: /**
357: * Add a domain shared library
358: *
359: * @param slName the name of the shared library
360: * @param fileName the shared library archive file name
361: * @throws RegistryException on errors
362: */
363: public void addSharedLibrary(String slName, String fileName,
364: Calendar timestamp) throws RegistryException {
365: }
366:
367: /**
368: * Add a domain component
369: *
370: * @param componentName the name of the component
371: * @param fileName the component archive file name
372: * @throws RegistryException on errors
373: */
374: public void addComponent(String componentName, String fileName,
375: Calendar timestamp) throws RegistryException {
376: }
377:
378: /**
379: * Add a service assembly to the domain.
380: *
381: * @param saName the service assembly name
382: * @param fileName the service assembly archive name
383: * @throws RegistryException on errors
384: */
385: public void addServiceAssembly(String saName, String fileName,
386: Calendar timestamp) throws RegistryException {
387: }
388:
389: /**
390: * Add a service assembly to he runtime's target
391: *
392: * @param saName - service assembly name
393: * @throws RegistryException on errors
394: */
395: public void addServiceAssembly(String saName)
396: throws RegistryException {
397: }
398:
399: /**
400: * Add a service assembly to a given target. If target = DOMAIN, then a simple
401: * entry is created with the assembly name. If the target = SERVER / CLUSTER
402: * a service-assembly-ref is added.
403: *
404: * @param targetName - {'domain', 'server', "instance-name", "cluster-name"}
405: * @param saName - service assembly name
406: * @throws RegistryException on errors
407: */
408: public void addServiceAssembly(String targetName, String saName)
409: throws RegistryException {
410: }
411:
412: /**
413: * Set the state of a component for the target at runtime.
414: *
415: * @param componentName the component name
416: * @param state the state to set.
417: * @throws RegistryException on errors
418: */
419: public void setComponentState(ComponentState state,
420: String componentName) throws RegistryException {
421: }
422:
423: /**
424: * Set the state of a component in a server/cluster.
425: *
426: * @param targetName either the server-name or cluster-name
427: * @param componentName the component name
428: * @param state the state to set.
429: * @throws RegistryException on errors
430: */
431: public void setComponentState(String targetName,
432: ComponentState state, String componentName)
433: throws RegistryException {
434: }
435:
436: /**
437: * Set the properties of a component in a server/cluster.
438: *
439: * @param targetName either the server-name or cluster-name, this operation
440: * is a no-op when target = domain.
441: * @param componentName the component name
442: * @param props the properties to set.
443: * @throws RegistryException on errors
444: */
445: public void setComponentProperties(String targetName,
446: Map<String, String> state, String componentName)
447: throws RegistryException {
448: }
449:
450: /**
451: * Set the state of a ServiceUnit for the runtime target.
452: *
453: * @param componentName the component name
454: * @param suName the service unit name
455: * @param state the state to set.
456: * @throws RegistryException on errors
457: */
458: public void setServiceUnitState(ServiceUnitState state,
459: String componentName, String suName)
460: throws RegistryException {
461: }
462:
463: /**
464: * Set the state of a ServiceUnit in a server / cluster.
465: *
466: * @param targetName either the value 'domain', 'server' or the
467: * server-name or cluster-name.
468: * @param componentName the component name
469: * @param suName the service unit name
470: * @param state the state to set.
471: * @throws RegistryException on errors
472: */
473: public void setServiceUnitState(String targetName,
474: ServiceUnitState state, String componentName, String suName)
475: throws RegistryException {
476: }
477:
478: /**
479: * Set the state of a ServiceAssembly for the runtime target.
480: *
481: * @param state - the state to set.
482: * @param saName - the service assembly name
483: * @throws RegistryException on errors
484: */
485: public void setServiceAssemblyState(ServiceAssemblyState state,
486: String saName) throws RegistryException {
487: }
488:
489: /**
490: * Set the state of a ServiceAssembly in a server / cluster.
491: *
492: * @param targetName - either the value 'domain', 'server' or the
493: * server-name or cluster-name.
494: * @param saName - service assembly name
495: * @param state - the state to set.
496: * @throws RegistryException on errors
497: */
498: public void setServiceAssemblyState(String targetName,
499: ServiceAssemblyState state, String saName)
500: throws RegistryException {
501: }
502:
503: /**
504: * Add a ServiceUnit to a Component for the runtime target.
505: *
506: * @param suInfo the ServiceUnitInfo
507: * @param componentName the component name
508: * @throws RegistryException on errors
509: */
510: public void addServiceUnitToComponent(String componentName,
511: ServiceUnitInfo suInfo) throws RegistryException {
512: }
513:
514: /**
515: * Add a ServiceUnit to a Component.
516: *
517: * @param suInfo the ServiceUnitInfo
518: * @param targetName either the value 'domain', 'server' or the
519: * server-name or cluster-name.
520: * @param componentName the component name
521: * @throws RegistryException on errors
522: */
523: public void addServiceUnitToComponent(String targetName,
524: String componentName, ServiceUnitInfo suInfo)
525: throws RegistryException {
526: }
527:
528: /**
529: * Remove a ServiceUnit from a Component for the runtime target.
530: *
531: * @param suName the service unit name
532: * @param componentName the component name
533: * @throws RegistryException on errors
534: */
535: public void removeServiceUnitFromComponent(String componentName,
536: String suName) throws RegistryException {
537: }
538:
539: /**
540: * Remove a ServiceUnit from a Component.
541: *
542: * @param suName the service unit name
543: * @param targetName the server-name or cluster-name.
544: * @param componentName the component name
545: * @throws RegistryException on errors
546: */
547: public void removeServiceUnitFromComponent(String targetName,
548: String componentName, String suName)
549: throws RegistryException {
550: }
551:
552: /**
553: * Set the file name for the domain component.
554: *
555: * @param fileName the name of the component archive
556: * @param componentName the component name
557: */
558: public void setComponentFileName(String fileName,
559: String componentName) throws RegistryException {
560: }
561:
562: /**
563: * Set the file name for the domain shared library.
564: *
565: * @param fileName the name of the shared library archive
566: * @param slName the shared library name
567: */
568: public void setSharedLibraryFileName(String fileName, String slName)
569: throws RegistryException {
570: }
571:
572: /**
573: * Set the file name for the domain service assembly.
574: *
575: * @param fileName the name of the service assembly archive
576: * @param saName the service assembly name
577: */
578: public void setServiceAssemblyFileName(String fileName,
579: String saName) throws RegistryException {
580: }
581:
582: /**
583: * This method is used to set the upgrade-number attribute in the domain
584: * level entry for a component
585: * @param componentName the component name
586: * @param upgradeNumber the update number
587: * @throws RegistryException if the update number could not be set
588: */
589: public void setComponentUpgradeNumber(String componentName,
590: java.math.BigInteger upgradeNumber)
591: throws RegistryException {
592:
593: }
594:
595: /**
596: * Set the value of a configuration attribute belonging to the
597: * specified category, for the runtime target.
598: *
599: * @param type - configuration category
600: * @param name - identification for the attribute
601: * @param value - string representation of the attribute value
602: * @exception RegistryException on errors in getting the attribute value
603: */
604: public void setAttribute(ConfigurationCategory type, String name,
605: String value) throws RegistryException {
606: }
607:
608: /**
609: * Get the value of a configuration attribute belonging to the
610: * specified category, for the runtime target.
611: *
612: * @param targetName - target instance/cluster name.
613: * @param type - configuration category
614: * @param name - identification for the attribute
615: * @param value - string representation of the attribute value
616: * @exception RegistryException on errors in getting the attribute value
617: */
618: public void setAttribute(String targetName,
619: ConfigurationCategory type, String name, String value)
620: throws RegistryException {
621: }
622:
623: /**
624: * Delete the named attribute from the category if it exists, for the implicit target
625: * The attribute is deleted only if it is overriden for the target, if target is "domain"
626: * the attribute is not deleted.
627: *
628: * @param type - configuration category
629: * @param name - identification for the attribute
630: * @exception RegistryException on errors in getting the attribute value
631: */
632: public void deleteAttribute(ConfigurationCategory type, String name)
633: throws RegistryException {
634:
635: }
636:
637: /**
638: * Delete the named attribute from the category if it exists, for the implicit target
639: * The attribute is deleted only if it is overriden for the target, if target is "domain"
640: * the attribute is not deleted.
641: *
642: * @param target - target name
643: * @param type - configuration category
644: * @param name - identification for the attribute
645: * @exception RegistryException on errors in getting the attribute value
646: */
647: public void deleteAttribute(String target,
648: ConfigurationCategory type, String name)
649: throws RegistryException {
650:
651: }
652:
653: ///////////////////////////////////////////////////////////////////////////////
654: //
655: // Methods from the ComponentQuery interface
656: //
657: ///////////////////////////////////////////////////////////////////////////////
658:
659: /**
660: * Get a list of component IDs of the specified type.
661: * @param type The type of component for which the IDs are requested.
662: * Can be one of: ComponentType.BINDING, ComponentType.ENGINE,
663: * ComponentType.SHARED_LIBRARY, ComponentType.BINDINGS_AND_ENGINES, or
664: * ComponentType.ALL.
665: * @return A list of Strings containing the component IDs.
666: */
667: public List<String> getComponentIds(ComponentType type) {
668: return new ArrayList();
669: }
670:
671: /**
672: * Get a list of component IDs of the specified type, with the
673: * specified status.
674: * @param type The type of component for which the IDs are requested.
675: * @param status The status for which the IDs are requested.
676: * Can be one of {LOADED, SHUTDOWN, STOPPED, STARTED}
677: * @return A list of Strings containing the component IDs. If no components
678: * were found, the list is empty.
679: */
680: public List<String> getComponentIds(ComponentType type,
681: ComponentState status) {
682: return mCompReg.getComponentIdsFromCache(type, status);
683: }
684:
685: /**
686: * Look up a component using its unique name.
687: * @param componentName the unique name of the component.
688: * @return the ComponentInfo instance containing all runtime information
689: * about the component or null if no component was found with the specified
690: * name.
691: */
692: public ComponentInfo getComponentInfo(String componentName) {
693: return null;
694: }
695:
696: /**
697: * Return a list of all component names dependent upon the specified Shared
698: * Library.
699: * @param sharedLibraryName - the unique name of the Shared Library.
700: * @return A list containing the unique names of all components that
701: * depend upon the Shared Library.
702: */
703: public List<String> getDependentComponentIds(
704: String sharedLibraryName) {
705: return new ArrayList();
706: }
707:
708: /**
709: * Look up a Shared Library using its unique name.
710: * @param sharedLibraryName the unique name of the Shared Library.
711: * @return the ComponentInfo instance containing all runtime information
712: * about the Shared Library or null if no Shared Library was found with the
713: * specified name.
714: */
715: public ComponentInfo getSharedLibraryInfo(String sharedLibraryName) {
716: return (ComponentInfo) mCompReg
717: .getSharedLibrary(sharedLibraryName);
718: }
719:
720: /**
721: * Get the current status of a Binding Component or Service Engine.
722: * @return the current status of the BC or SE.
723: * @throws javax.jbi.JBIException if the component name is not found.
724: */
725: public ComponentState getStatus(String componentName)
726: throws javax.jbi.JBIException {
727: return mCompReg.getStatus(componentName);
728: }
729:
730: /**
731: * Set the value of a configuration attribute for a component installed on a target
732: * for the runtime target.
733: * @param name - identification for the attribute
734: * @param value - string representation of the attribute value
735: * @param componentName - identification for the component
736: * @exception RegistryException on errors in getting the attribute value
737: */
738: public void setComponentAttribute(String componentName,
739: String name, String value) throws RegistryException {
740:
741: }
742:
743: /**
744: * Set the value of a configuration attribute for a component installed on a target,
745: *
746: * @param targetName - target instance/cluster name.
747: * @param name - identification for the attribute
748: * @param value - string representation of the attribute value
749: * @param componentName - identification for the component
750: * @exception RegistryException on errors in getting the attribute value
751: */
752: public void setComponentAttribute(String componentName,
753: String targetName, String name, String value)
754: throws RegistryException {
755:
756: }
757:
758: /**
759: * Set the value of a configuration attribute for a component installed on a target
760: * for the runtime target.
761: * @param props - properties to set
762: * @param componentName - identification for the component
763: * @exception RegistryException on errors in getting the attribute value
764: */
765: public void setComponentAttributes(String componentName,
766: Properties props) throws RegistryException {
767:
768: }
769:
770: /**
771: * Set the value of a configuration attribute for a component installed on a target,
772: *
773: * @param targetName - target instance/cluster name.
774: * @param props - properties to set
775: * @param componentName - identification for the component
776: * @exception RegistryException on errors in getting the attribute value
777: */
778: public void setComponentAttributes(String componentName,
779: String targetName, Properties props)
780: throws RegistryException {
781:
782: }
783:
784: /**
785: * Add a set of application variables to the registry for the runtime target.
786: *
787: * @param appVars - list of application variables to be added to the registry
788: * @exception RegistryException on errors in adding the application variables.
789: */
790: public void addComponentApplicationVariables(String componentName,
791: com.sun.jbi.management.ComponentInfo.Variable[] appVars)
792: throws RegistryException {
793:
794: }
795:
796: /**
797: * Add a set of application variables to the registry for the specified target.
798: *
799: * @param appVars - list of application variables to be added to the registry
800: * @param targetName - target to be updated
801: * @exception RegistryException on errors in adding the application variables.
802: */
803: public void addComponentApplicationVariables(String componentName,
804: String targetName,
805: com.sun.jbi.management.ComponentInfo.Variable[] appVars)
806: throws RegistryException {
807:
808: }
809:
810: /**
811: * Update a set of application variables to the registry for the runtime target.
812: *
813: * @param appVars - list of application variables to be updated
814: * @exception RegistryException on errors in updating the application variables.
815: */
816: public void updateComponentApplicationVariables(
817: String componentName,
818: com.sun.jbi.management.ComponentInfo.Variable[] appVars)
819: throws RegistryException {
820:
821: }
822:
823: /**
824: * Updated a set of application variables to the registry for the specified target.
825: *
826: * @param appVars - list of application variables to be updated
827: * @param targetName - target to be updated
828: * @exception RegistryException on errors in updating the application variables.
829: */
830: public void updateComponentApplicationVariables(
831: String componentName, String targetName,
832: com.sun.jbi.management.ComponentInfo.Variable[] appVars)
833: throws RegistryException {
834:
835: }
836:
837: /**
838: * Delete a set of application variables from the registry for the runtime target.
839: *
840: * @param appVars - list of application variables to be deleted from the registry
841: * @param names - the names of the variables to be deleted.
842: * @exception RegistryException on errors in deleting the application variables.
843: */
844: public void deleteComponentApplicationVariables(
845: String componentName, String[] names)
846: throws RegistryException {
847:
848: }
849:
850: /**
851: * Add a set of application variables to the registry for the specified target.
852: *
853: * @param appVars - list of application variables to be deleted from the registry
854: * @param targetName - target to be updated
855: * @param names - the names of the variables to be deleted.
856: * @exception RegistryException on errors in deleting the application variables.
857: */
858: public void deleteComponentApplicationVariables(
859: String componentName, String targetName, String[] names)
860: throws RegistryException {
861:
862: }
863:
864: /**
865: * Add a named application configuration to the registry for the component for the
866: * implicit runtime target.
867: *
868: * @param componentName
869: * component identification
870: * @param appConfig
871: * named application configuration represented as properties
872: * @exception RegistryException on errors in adding the application configuration.
873: */
874: public void addComponentApplicationConfiguration(
875: String componentName, Properties appConfig)
876: throws RegistryException {
877:
878: }
879:
880: /**
881: * Add a named application configuration to the registry for the component for the
882: * specified runtime target.
883: *
884: * @param componentName
885: * component identification
886: * @param appConfig
887: * named application configuration represented as properties
888: * @param targetName
889: * target name
890: * @exception RegistryException on errors in adding the application configuration.
891: */
892: public void addComponentApplicationConfiguration(
893: String componentName, String targetName,
894: Properties appConfig) throws RegistryException {
895:
896: }
897:
898: /**
899: * Update a named application configuration set on a component
900: * for the implicit runtime target.
901: *
902: * @param componentName
903: * component identification
904: * @param appConfig
905: * named application configuration represented as properties
906: * @exception RegistryException on errors in updating the application configuration.
907: */
908: public void updateComponentApplicationConfiguration(
909: String componentName, Properties appConfig)
910: throws RegistryException {
911:
912: }
913:
914: /**
915: * Update a named application configuration set on a component
916: * for the specified runtime target.
917: *
918: * @param componentName
919: * component identification
920: * @param appConfig
921: * named application configuration represented as properties
922: * @param targetName
923: * target name
924: * @exception RegistryException on errors in updating the application configuration.
925: */
926: public void updateComponentApplicationConfiguration(
927: String componentName, String targetName,
928: Properties appConfig) throws RegistryException {
929:
930: }
931:
932: /**
933: * Delete a named application configuration
934: *
935: * @param appConfigName
936: * name of the application configuration to delete.
937: * @param componentName
938: * component identification
939: * @exception RegistryException on errors in deleting the application configuration.
940: */
941: public void deleteComponentApplicationConfiguration(
942: String componentName, String appConfigName)
943: throws RegistryException {
944:
945: }
946:
947: /**
948: * Delete a named application configuration
949: *
950: * @param componentName
951: * component identification
952: * @param targetName
953: * target name
954: * @param appConfigName
955: * the name of the configuration to be deleted.
956: * @exception RegistryException on errors in deleting the application configuration.
957: */
958: public void deleteComponentApplicationConfiguration(
959: String componentName, String targetName,
960: String appConfigName) throws RegistryException {
961:
962: }
963: }
|