org.apache.tools.ant.taskdefs.optional.ejb

Class WLRun


public class WLRun
extends Task

Starts a WebLogic server. A number of parameters are used to control the operation of the weblogic instance. Note that the task, and hence ant, will not complete until the weblogic instance is stopped.

Field Summary

protected static String
DEFAULT_PROPERTIES_FILE
protected static String
DEFAULT_WL51_POLICY_FILE
protected static String
DEFAULT_WL60_POLICY_FILE

Fields inherited from class org.apache.tools.ant.Task

description, location, target, taskName, taskType, wrapper

Fields inherited from class org.apache.tools.ant.ProjectComponent

project

Method Summary

Path
createClasspath()
Add the classpath for the user classes
Path
createWLClasspath()
Get the classpath to the weblogic classpaths
void
execute()
Do the work.
void
setArgs(String args)
Additional argument string passed to the Weblogic instance; optional.
void
setBEAHome(File beaHome)
The location of the BEA Home; implicitly selects Weblogic 6.0; optional.
void
setClasspath(Path classpath)
The classpath to be used with the Java Virtual Machine that runs the Weblogic Server; required.
void
setDomain(String domain)
Set the Domain to run in; required for WL6.0
void
setHome(File weblogicHome)
The location where weblogic lives.
void
setJvmargs(String args)
Set the additional arguments to pass to the weblogic JVM
void
setName(String serverName)
The name of the weblogic server within the weblogic home which is to be run.
void
setPKPassword(String pkpassword)
Set the private key password so the server can decrypt the SSL private key file; optional and only applicable to WL6.0.
void
setPassword(String password)
Set the management password of the server; optional and only applicable to WL6.0.
void
setPolicy(String securityPolicy)
The name of the security policy file within the weblogic home directory that is to be used.
void
setProperties(String propertiesFilename)
The name of the server's properties file within the weblogic home directory used to control the weblogic instance; required for WL4.5.1
void
setUsername(String username)
Set the management username to run the server; optional and only applicable to WL6.0.
void
setWeblogicMainClass(String c)
name of the main class for weblogic; optional.
void
setWlclasspath(Path weblogicClasspath)
Set the weblogic classpath used by the Weblogic Server; optional, and only applicable to WL4.5.1 The weblogic classpath is used by weblogic to support dynamic class loading.

Methods inherited from class org.apache.tools.ant.Task

execute, getDescription, getLocation, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, maybeConfigure, perform, reconfigure, setDescription, setLocation, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType

Methods inherited from class org.apache.tools.ant.ProjectComponent

getProject, log, log, setProject

Field Details

DEFAULT_PROPERTIES_FILE

protected static final String DEFAULT_PROPERTIES_FILE

DEFAULT_WL51_POLICY_FILE

protected static final String DEFAULT_WL51_POLICY_FILE

DEFAULT_WL60_POLICY_FILE

protected static final String DEFAULT_WL60_POLICY_FILE

Method Details

createClasspath

public Path createClasspath()
Add the classpath for the user classes

createWLClasspath

public Path createWLClasspath()
Get the classpath to the weblogic classpaths

execute

public void execute()
            throws BuildException
Do the work. The work is actually done by creating a separate JVM to run a helper task. This approach allows the classpath of the helper task to be set. Since the weblogic tools require the class files of the project's home and remote interfaces to be available in the classpath, this also avoids having to start ant with the class path of the project it is building.
Overrides:
execute in interface Task
Throws:
BuildException - if someting goes wrong with the build

setArgs

public void setArgs(String args)
Additional argument string passed to the Weblogic instance; optional.

setBEAHome

public void setBEAHome(File beaHome)
The location of the BEA Home; implicitly selects Weblogic 6.0; optional.
Parameters:
beaHome - the BEA Home directory.

setClasspath

public void setClasspath(Path classpath)
The classpath to be used with the Java Virtual Machine that runs the Weblogic Server; required. Prior to Weblogic 6.0, this is typically set to the Weblogic boot classpath. Under Weblogic 6.0 this should include all the weblogic jars
Parameters:
classpath - the classpath to use when executing the weblogic server.

setDomain

public void setDomain(String domain)
Set the Domain to run in; required for WL6.0
Parameters:
domain - the domain

setHome

public void setHome(File weblogicHome)
The location where weblogic lives. Required. This is the absolute location, not relative to BEA home.
Parameters:
weblogicHome - the home directory of weblogic.

setJvmargs

public void setJvmargs(String args)
Set the additional arguments to pass to the weblogic JVM
Parameters:
args - the arguments to be passed to the JVM

setName

public void setName(String serverName)
The name of the weblogic server within the weblogic home which is to be run. Optiona, defaults to "myserver"
Parameters:
serverName - the name of the server.

setPKPassword

public void setPKPassword(String pkpassword)
Set the private key password so the server can decrypt the SSL private key file; optional and only applicable to WL6.0.
Parameters:
pkpassword - the private key password,

setPassword

public void setPassword(String password)
Set the management password of the server; optional and only applicable to WL6.0.
Parameters:
password - the management pasword of the server.

setPolicy

public void setPolicy(String securityPolicy)
The name of the security policy file within the weblogic home directory that is to be used. If not specified, the default policy file weblogic.policy is used.
Parameters:
securityPolicy - the security policy to use.

setProperties

public void setProperties(String propertiesFilename)
The name of the server's properties file within the weblogic home directory used to control the weblogic instance; required for WL4.5.1
Parameters:
propertiesFilename - the properties file name

setUsername

public void setUsername(String username)
Set the management username to run the server; optional and only applicable to WL6.0.
Parameters:
username - the management username of the server.

setWeblogicMainClass

public void setWeblogicMainClass(String c)
name of the main class for weblogic; optional.

setWlclasspath

public void setWlclasspath(Path weblogicClasspath)
Set the weblogic classpath used by the Weblogic Server; optional, and only applicable to WL4.5.1 The weblogic classpath is used by weblogic to support dynamic class loading.
Parameters:
weblogicClasspath - the weblogic classpath

Copyright B) 2000-2007 Apache Software Foundation. All Rights Reserved.