|
BEA Systems, Inc. | ||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectweblogic.deploy.api.model.WebLogicDeployableObject
public class WebLogicDeployableObject
This class is the WebLogic Server implementation of DeployableObject
.
WebLogicDeployableObject encapsulates a single module for deployment purposes.
A deployment tool uses the constructors for this class to present an application module to
the deployer. When the tool is done with this object it is highly recommended that it be formally closed (see
WebLogicDeployableObject.close()
). This ensures resources are closed and removes any temporary files that may have been
created.
Applications can be part of a parent installation directory. This directory structure has the following organization:
install-root (eg myapp) -- app ----- archive (eg myapp.ear) -- plan ----- deployment plan (eg plan.xml) ----- external descriptors (eg META-INF/weblogic-application.xml ...)
Nested Class Summary | |
---|---|
protected class |
WebLogicDeployableObject.DDRootFields
|
Field Summary | |
---|---|
protected weblogic.deploy.api.internal.utils.ClassLoaderControl |
clf
|
protected String |
contextRoot
|
protected WebLogicDeployableObject.DDRootFields |
ddRoot
|
protected boolean |
deleteOnClose
|
protected boolean |
haveAppRoot
indicates whether user provided an app root |
protected weblogic.deploy.api.internal.utils.LibrarySpec[] |
libraries
|
protected File |
plan
|
protected weblogic.j2ee.descriptor.wl.DeploymentPlanBean |
planBean
|
protected File |
plandir
|
protected weblogic.utils.classloaders.ClassFinder |
resourceFinder
|
protected String |
uri
for embedded modules, this is uri to their root |
Constructor Summary | |
---|---|
protected |
WebLogicDeployableObject(File module,
ModuleType moduleType,
WebLogicJ2eeApplicationObject parent,
String uri,
String altdd,
File installDir,
File plan,
File plandir)
|
Method Summary | |
---|---|
void |
addRootBean(String uriArg,
weblogic.descriptor.DescriptorBean db,
ModuleType mt)
|
void |
close()
Closes application resources and removes temporary files. |
protected void |
closeGCL()
|
protected void |
closeResourceFinder()
|
protected void |
closeVJF()
|
static WebLogicDeployableObject |
createDeployableObject(File app)
Deprecated. since WLS 9.2. |
static WebLogicDeployableObject |
createDeployableObject(File app,
File appRoot)
Deprecated. since WLS 9.2. |
static WebLogicDeployableObject |
createDeployableObject(File app,
File appRoot,
File plan,
File plandir,
weblogic.deploy.api.internal.utils.LibrarySpec[] libraries)
Deprecated. since WLS 9.2. |
static WebLogicDeployableObject |
createLazyDeployableObject(File app,
File appRoot)
Deprecated. since WLS 9.2. |
Enumeration |
entries()
Returns an enumeration of the module file entries. |
DDBean[] |
getChildBean(String xpath)
Returns DDBeans based on the specified xpath expression, relative to the root element of the primary descriptor of this DeployableObject. |
Class |
getClassFromScope(String className)
Returns the Class object from this module for the named class, or null if there is no class. |
String |
getContextRoot()
|
DDBeanRoot |
getDDBeanRoot()
Returns the root DDBean for this module. |
DDBeanRoot |
getDDBeanRoot(String filename)
Returns a DDBeanRoot object for the named XML instance document. |
DDBeanRoot[] |
getDDBeanRoots()
List of DDBeanRoot objects representing all of the known deployment descriptors for this module |
protected InputStream |
getDDStream(String altdd,
ModuleType moduleType)
|
weblogic.descriptor.DescriptorBean |
getDescriptorBean()
Typed descriptor bean tree for this modules standard descriptor. |
InputStream |
getEntry(String name)
Returns an InputStream for the given entry name. |
weblogic.deploy.api.internal.utils.LibrarySpec[] |
getLibraries()
|
String |
getModuleDTDVersion()
Deprecated. As of version 1.1, replaced by DDBeanRoot.getDDBeanRootVersion() |
WebLogicJ2eeApplicationObject |
getParent()
|
File |
getPlan()
|
weblogic.j2ee.descriptor.wl.DeploymentPlanBean |
getPlanBean()
|
File |
getPlandir()
|
weblogic.utils.classloaders.ClassFinder |
getResourceFinder()
|
protected InputStream |
getStreamFromParent(String uri,
String name)
|
String[] |
getText(String xpath)
Returns XML content for each matching element in this module's descriptor. |
ModuleType |
getType()
Returns the ModuleType of the deployment descriptor (for example, the EAR, JAR, WAR, or RAR) that this DeployableObject represents. |
void |
setContextRoot(String contextRoot)
|
protected void |
setDDBeanRoot(DDBeanRoot root)
|
protected void |
setLibraries(weblogic.deploy.api.internal.utils.LibrarySpec[] libraries)
|
protected void |
setPlan(File plan)
|
protected void |
setPlanDir(File plandir)
|
void |
setResourceFinder(weblogic.utils.classloaders.ClassFinder finder)
|
protected void |
setupDDBeanRoot(weblogic.deploy.api.model.internal.DDBeanRootImpl root)
|
protected void |
setUri(String u)
|
String |
toString()
Returns a String representation of the module type and archive. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
protected String uri
protected boolean haveAppRoot
protected WebLogicDeployableObject.DDRootFields ddRoot
protected weblogic.deploy.api.internal.utils.ClassLoaderControl clf
protected File plan
protected File plandir
protected weblogic.j2ee.descriptor.wl.DeploymentPlanBean planBean
protected weblogic.deploy.api.internal.utils.LibrarySpec[] libraries
protected boolean deleteOnClose
protected weblogic.utils.classloaders.ClassFinder resourceFinder
protected String contextRoot
Constructor Detail |
---|
protected WebLogicDeployableObject(File module, ModuleType moduleType, WebLogicJ2eeApplicationObject parent, String uri, String altdd, File installDir, File plan, File plandir) throws IOException
IOException
Method Detail |
---|
protected void setLibraries(weblogic.deploy.api.internal.utils.LibrarySpec[] libraries)
public File getPlandir()
public File getPlan()
public weblogic.j2ee.descriptor.wl.DeploymentPlanBean getPlanBean() throws IOException
IOException
public void addRootBean(String uriArg, weblogic.descriptor.DescriptorBean db, ModuleType mt)
protected void setPlanDir(File plandir)
protected void setPlan(File plan)
protected void setupDDBeanRoot(weblogic.deploy.api.model.internal.DDBeanRootImpl root) throws IOException, InvalidModuleException
IOException
InvalidModuleException
protected InputStream getDDStream(String altdd, ModuleType moduleType) throws FileNotFoundException
FileNotFoundException
public ModuleType getType()
getType
in interface DeployableObject
public DDBean[] getChildBean(String xpath)
getChildBean
in interface DeployableObject
public Class getClassFromScope(String className)
getClassFromScope
in interface DeployableObject
public DDBeanRoot getDDBeanRoot()
SessionHelper.inspect()
then it may throw
an unchecked RuntimeException indicating parse failures
getDDBeanRoot
in interface DeployableObject
protected void setDDBeanRoot(DDBeanRoot root)
public String[] getText(String xpath)
getText
in interface DeployableObject
xpath
- Is an xpath expression relative to root element of this
module.public DDBeanRoot getDDBeanRoot(String filename) throws FileNotFoundException, javax.enterprise.deploy.model.exceptions.DDBeanCreateException
The descriptor will be parsed and a full tree of DDBean's are created.
getDDBeanRoot
in interface DeployableObject
filename
- The full path name of the XML instance document to return,
specified from the root of the module. The path must be either relative to
the root of this module, or in the same relative location in the module's
external configuration directory.
FileNotFoundException
- If the named file cannot be found
javax.enterprise.deploy.model.exceptions.DDBeanCreateException
- If an error is encountered while creating the DDBeanRoot object.public Enumeration entries()
entries
in interface DeployableObject
public InputStream getEntry(String name)
getEntry
in interface DeployableObject
name
- The file name relative to the root of the module.
protected InputStream getStreamFromParent(String uri, String name) throws IOException
IOException
public String getModuleDTDVersion()
getModuleDTDVersion
in interface DeployableObject
public weblogic.descriptor.DescriptorBean getDescriptorBean() throws IOException
IOException
public static WebLogicDeployableObject createDeployableObject(File app) throws InvalidModuleException, IOException
app
- is the archive or root directory of the application.
InvalidModuleException
IOException
public static WebLogicDeployableObject createDeployableObject(File app, File appRoot) throws InvalidModuleException, IOException
app
- is the archive or root directory of the application.appRoot
- is application's installation root directory.
InvalidModuleException
IOException
public static WebLogicDeployableObject createDeployableObject(File app, File appRoot, File plan, File plandir, weblogic.deploy.api.internal.utils.LibrarySpec[] libraries) throws IOException, InvalidModuleException, ConfigurationException
app
- is the archive or root directory of the application.appRoot
- is application's installation root directory. May be null.plan
- is the deployment plan to use for this session. May be null.plandir
- is the plan directory to use for this session. If null
the plan directory is derived from the plan or app root provided.libraries
- is a collection of library references to merge with the app.
This argument allows for the presence of multiple directories and plans
to be associated with the app. If null then no attempt will be made to merge.
IOException
InvalidModuleException
ConfigurationException
public weblogic.deploy.api.internal.utils.LibrarySpec[] getLibraries()
public static WebLogicDeployableObject createLazyDeployableObject(File app, File appRoot) throws InvalidModuleException, IOException
InvalidModuleException
IOException
public String toString()
toString
in class Object
public DDBeanRoot[] getDDBeanRoots()
public WebLogicJ2eeApplicationObject getParent()
protected void setUri(String u)
public void close()
close
in interface weblogic.deploy.api.internal.Closable
protected void closeGCL()
protected void closeResourceFinder()
protected void closeVJF()
public void setResourceFinder(weblogic.utils.classloaders.ClassFinder finder)
public weblogic.utils.classloaders.ClassFinder getResourceFinder()
public String getContextRoot()
public void setContextRoot(String contextRoot)
|
Documentation is available at http://download.oracle.com/docs/cd/E13222_01/wls/docs92 Copyright 2006 BEA Systems Inc. |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |