alsbconfigurationmbean.html

一个实用的java源程序

</DD>
</DL>
<HR>

<A NAME="export(java.util.Collection, boolean, java.lang.String)"><!-- --></A><H3>
export</H3>
<PRE>
byte[] <B>export</B>(<A HREF="http://java.sun.com/j2se/1.5/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A>&lt;<A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&gt;&nbsp;refsToExport,
              boolean&nbsp;includeDependencies,
              <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;passphrase)
              throws <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></PRE>
<DL>
<DD>Exports the given collection of references and returns bytes that make up the export data.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>refsToExport</CODE> - array of references to items to be exported. A reference to a resource
      causes that resource to be exported. If there is a reference to a folder, project, or the
      domain (via <A HREF="../../../../../../com/bea/wli/config/Ref.html#DOMAIN"><CODE>Ref.DOMAIN</CODE></A>) then all resources under these are exported as well.
      In order to export all the resources simply call this method with <A HREF="../../../../../../com/bea/wli/config/Ref.html#DOMAIN"><CODE>Ref.DOMAIN</CODE></A>.<DD><CODE>includeDependencies</CODE> - whether to include dependencies of the resources that are given in the
      refsToExport parameter<DD><CODE>passphrase</CODE> - the passphrase to use if encryption will be done
<DT><B>Returns:</B><DD>bytes that make up an exported configuration in the form of a zip file. The result can be
      saved as a zip file and inspected with relevant tools.
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></CODE><DT><B>Since:</B></DT>
  <DD>2.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="uploadJarFile(byte[])"><!-- --></A><H3>
uploadJarFile</H3>
<PRE>
<A HREF="http://java.sun.com/j2se/1.5/docs/api/java/util/Set.html" title="class or interface in java.util">Set</A>&lt;<A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&gt; <B>uploadJarFile</B>(byte[]&nbsp;data)
                       throws <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></PRE>
<DL>
<DD>Obtains configuration data from a configuration jar file and locally (temporarily) stages it
 on the server. The import is finished by invoking the <A HREF="../../../../../../com/bea/wli/sb/management/configuration/ALSBConfigurationMBean.html#importUploaded(com.bea.wli.sb.management.importexport.ALSBImportPlan)"><CODE>importUploaded(com.bea.wli.sb.management.importexport.ALSBImportPlan)</CODE></A> method.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>data</CODE> - contents of a previously exported configuration jar file.
<DT><B>Returns:</B><DD>set of references to resources found in the jar file
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></CODE><DT><B>Since:</B></DT>
  <DD>2.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="findEnvValues(com.bea.wli.config.env.EnvValueQuery)"><!-- --></A><H3>
findEnvValues</H3>
<PRE>
<A HREF="http://java.sun.com/j2se/1.5/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A>&lt;<A HREF="../../../../../../com/bea/wli/config/env/QualifiedEnvValue.html" title="class in com.bea.wli.config.env">QualifiedEnvValue</A>&gt; <B>findEnvValues</B>(<A HREF="../../../../../../com/bea/wli/config/env/EnvValueQuery.html" title="class in com.bea.wli.config.env">EnvValueQuery</A>&nbsp;query)</PRE>
<DL>
<DD>Searches environment specific values based on the given query
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>query</CODE> - the search criteria for the environment values.
<DT><B>Returns:</B><DD>collection of environment values that satisfy the given search criteria.<DT><B>Since:</B></DT>
  <DD>2.5</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="clone(com.bea.wli.config.Ref, com.bea.wli.config.Ref)"><!-- --></A><H3>
clone</H3>
<PRE>
void <B>clone</B>(<A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&nbsp;sourceRef,
           <A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&nbsp;targetRef)
           throws <A HREF="../../../../../../com/bea/wli/config/component/AlreadyExistsException.html" title="class in com.bea.wli.config.component">AlreadyExistsException</A>,
                  <A HREF="../../../../../../com/bea/wli/config/component/NotFoundException.html" title="class in com.bea.wli.config.component">NotFoundException</A>,
                  <A HREF="../../../../../../com/bea/wli/config/component/CreateException.html" title="class in com.bea.wli.config.component">CreateException</A></PRE>
<DL>
<DD>Clones a given source project, folder or resource with a new identity. The clone operation
 allows user to clone the artifact into an arbitrary location with an arbitrary name.
 For example a resource "P1/F1/resourceA" can be cloned as "P2/F2/F3/resourceB" <p>

 Cloning a resource simply creates a copy of that resource with the given target identity.
 The clone will remain to have the same references as the original one. Moreover any other
 resources that were referencing the original resource will continue to reference the original.
 (This behavior is different when cloning a project or folder).<p>

 Cloning a location (project or folder) works differently from cloning a resource.
 It effectively clones all artifacts under that location (including folders)
 to a different location. Moreover the following are also performed.<p>
 <ul>
 <li> a project can be cloned to be a folder, effectively demoting it (e.g., clone "P1" as "P2/f2").
 <li> a folder can be cloned to be a project, effectively promoting it (e.g., clone "P1/f1", as "P2").
 <li> a location (folder or project) can be cloned to be an existing location effectively merging two locations.
      In this case the contents
      are merged. For example if "P1/f1" is clones as "P2/f2" and both locations have some artifacts,
      the P2/f2 will have combined set of artifacts.
 <li> location properties such as its description are copied (if the target location does not exist)
 <li> all the resources that are cloned will have their references adjusted in the following manner: any
      reference to a resource that is also being cloned, will be changed so that it will reference
      the cloned resource and not the original resource. Any reference to a resource that is not being
      cloned as part of the clone operation (i.e., outside the source location) will remain the same.
 </ul>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>sourceRef</CODE> - the reference to the resource, project or folder to be cloned.<DD><CODE>targetRef</CODE> - the new identity of the cloned resource, project or folder. If the sourceRef
      is a resource, the targetRef must be of the same resource type. If sourceRef is a location
      (project or folder) the targetRef must be a location too. However the user can specify a folder
      in the sourceRef and a project as the targetRef, or vice versa. The former effectively promotes
      a folder to be a project, whereas the latter demotes a project to be a folder.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../../com/bea/wli/config/component/AlreadyExistsException.html" title="class in com.bea.wli.config.component">AlreadyExistsException</A></CODE> - if the target resource, project or folder (targetRef) already exists
<DD><CODE><A HREF="../../../../../../com/bea/wli/config/component/NotFoundException.html" title="class in com.bea.wli.config.component">NotFoundException</A></CODE> - if the source is not found or if the parent location (project or folder) of the
      targetRef does not exist. For example if a folder "P1/sourceFolder" is to be cloned as "P2/F2/F3/targetFolder"
      the parent location, which is "P2/F2/F3" must exist.
<DD><CODE><A HREF="../../../../../../com/bea/wli/config/component/CreateException.html" title="class in com.bea.wli.config.component">CreateException</A></CODE> - if there is any other error while creating a resource.<DT><B>Since:</B></DT>
  <DD>2.6</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="mapReferences(java.util.Collection, java.util.Map)"><!-- --></A><H3>
mapReferences</H3>
<PRE>
<A HREF="http://java.sun.com/j2se/1.5/docs/api/java/util/Set.html" title="class or interface in java.util">Set</A>&lt;<A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&gt; <B>mapReferences</B>(<A HREF="http://java.sun.com/j2se/1.5/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A>&lt;<A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&gt;&nbsp;resourcesToConsider,
                       <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/util/Map.html" title="class or interface in java.util">Map</A>&lt;<A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>,<A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&gt;&nbsp;refMap)
                       throws <A HREF="../../../../../../com/bea/wli/config/component/NotFoundException.html" title="class in com.bea.wli.config.component">NotFoundException</A>,
                              <A HREF="../../../../../../com/bea/wli/config/component/UpdateException.html" title="class in com.bea.wli.config.component">UpdateException</A></PRE>
<DL>
<DD>Modifies the existing references from all the resources in the given list (resourcesToConsider)
 to a new set of references passed in the refMap. refMap is validated first for any invalid
 or cyclic references. resourcesToConsider can also contain Project or Folder, in which case
 all the resources in that project or folder are modified with the new set of references
 passed in the refMap.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>resourcesToConsider</CODE> - list of resources to be modified with the new references<DD><CODE>refMap</CODE> - map of references. key is the old ref and value is the new ref
<DT><B>Returns:</B><DD>the set of refs to resources that were changed
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if the refMap is not valid
<DD><CODE><A HREF="../../../../../../com/bea/wli/config/component/NotFoundException.html" title="class in com.bea.wli.config.component">NotFoundException</A></CODE> - if the resource given in the resourcesToConsider does not exist
<DD><CODE><A HREF="../../../../../../com/bea/wli/config/component/UpdateException.html" title="class in com.bea.wli.config.component">UpdateException</A></CODE> - if there is any error while trying to update the resources<DT><B>Since:</B></DT>
  <DD>2.6</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getRefs(com.bea.wli.config.resource.BaseQuery)"><!-- --></A><H3>
getRefs</H3>
<PRE>
<A HREF="http://java.sun.com/j2se/1.5/docs/api/java/util/Set.html" title="class or interface in java.util">Set</A>&lt;<A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&gt; <B>getRefs</B>(<A HREF="../../../../../../com/bea/wli/config/resource/BaseQuery.html" title="class in com.bea.wli.config.resource">BaseQuery</A>&nbsp;query)
                 throws <A HREF="../../../../../../com/bea/wli/config/component/NotFoundException.html" title="class in com.bea.wli.config.component">NotFoundException</A></PRE>
<DL>
<DD>Searches for resources using the given query and returns a set of refs.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>query</CODE> - You can pass either <A HREF="../../../../../../com/bea/wli/config/resource/ResourceQuery.html" title="class in com.bea.wli.config.resource"><CODE>ResourceQuery</CODE></A> or
              <A HREF="../../../../../../com/bea/wli/config/resource/DependencyQuery.html" title="class in com.bea.wli.config.resource"><CODE>DependencyQuery</CODE></A>.
<DT><B>Returns:</B><DD>the resulted resources as a set of refs
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../../com/bea/wli/config/component/NotFoundException.html" title="class in com.bea.wli.config.component">NotFoundException</A></CODE> - if a resource to a reference is not found<DT><B>Since:</B></DT>
  <DD>2.6</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="importZip(com.bea.wli.config.Ref, byte[], java.util.Map)"><!-- --></A><H3>
importZip</H3>
<PRE>
<A HREF="../../../../../../com/bea/wli/config/importexport/BulkImportResult.html" title="interface in com.bea.wli.config.importexport">BulkImportResult</A> <B>importZip</B>(<A HREF="../../../../../../com/bea/wli/config/Ref.html" title="class in com.bea.wli.config">Ref</A>&nbsp;location,
                           byte[]&nbsp;zipcontent,
                           <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/util/Map.html" title="class or interface in java.util">Map</A>&lt;<A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>,<A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&gt;&nbsp;extensions)
                           throws <A HREF="http://java.sun.com/j2se/1.5/docs/api/java/lang/Exception.html" title="class or interface in java.lang">Exception</A></PRE>
<DL>
<DD>Imports the resources from a zip file. This method tries to import all the
 resources in the zip file. The zip file can contain the following types:
 WSDL, XML Schema, XQuery, XSLT, WS-Policy, MFL and Archive.
 Use <A HREF="../../../../../../com/bea/wli/sb/util/ZipUtils.html#getDefaultExtensionMap()"><CODE>ZipUtils.getDefaultExtensionMap()</CODE></A> method to get
 the default extension to resource mapping.<br>

 Name of the resource will be the name of the file with out the extension. If the
 resource is under a directory in the zip file, the same directory structure  is
 created under the project or folder represented by location attribute.<br>

 If an extension is not mapped to any supported resource (or if there is no extension),
 those resources cannot be imported. The reason for failure can be obtained from the
 return value. Ref for these files in the Diagnostics will be null.<br>

 If the resource already exists, it will be updated. Otherwise it will be created.
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>location</CODE> - the reference of the project or folder that will receive the resources.
      If the location does not exist it throws NotFoundException.<DD><CODE>zipcontent</CODE> - the byte content of the zip file to load<DD><CODE>extensions</CODE> - the map <file extension / resource type> used to associate