TargetPolicyDefault (IBM WebSphere Application Server, Release 8.5)

java.lang.Object
- com.ibm.websphere.command.TargetPolicyDefault

All Implemented Interfaces:

TargetPolicy, java.io.Serializable
```
public class TargetPolicyDefault
extends java.lang.Object
implements TargetPolicy, java.io.Serializable
```
The TargetPolicyDefault class provides an implementation of the TargetPolicy interface. It provides serveral way to specify the target for a command, and it implements an evaluation routine for retrieving the target in its implementation of the getCommandTarget() method.

The TargetPolicyDefault class allows a client to set the target of a command in several ways:
- The target can be set directly on the command by using the setCommandTarget() method in the TargetableCommand interface.
- The name of the target can be set directly on the command by using the setCommandTargetName() method on the TargetableCommand interface.
- A command can be mapped to a target using the local registerCommand() method. The TargetPolicyDefault class also provides methods for managing these mappings.
- A default target can be established by using the local setDefaultTargetName() method.
The getCommandTarget() method implements the following ordered steps for determining the target that to be returned for a given command. The getCommandTarget() method stops when it finds a target.
1. If the command contains a target object, use it.
2. If the command contains a name for a target, use it.
3. If there is a mapping registered on the TargetPolicyDefault object between the command and a target, use it.
4. If there is a default target name defined on the TargetPolicyDefault object, use it.
5. Return null if no target can be found.
The class sets the default target name to the LocalTarget class.
See Also:
Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected CommandTarget`	`defaultTarget` The default target object, used if no other target is found.
`protected java.lang.String`	`defaultTargetName` The default target name, used if no other target is found.
`protected java.util.Dictionary`	`mapping` Contains the registered mappings between commands and targets.
`protected java.util.Hashtable`	`targetTable` Contains active targets.

Constructor Summary

Constructors
Constructor and Description

TargetPolicyDefault()

Constructors
Constructor and Description
`TargetPolicyDefault()`

Method Summary

Methods
Modifier and Type	Method and Description
`CommandTarget`	`getCommandTarget(TargetableCommand command)` The getCommandTarget() method implements the method in the TargetPolicy interface.
`java.util.Dictionary`	`listMappings()` Lists all the command-to-target mappings.
`void`	`registerCommand(java.lang.String commandBeanName, java.lang.String targetBeanName)` Registers a single command-to-target mapping.
`void`	`setDefaultTargetName(java.lang.String defaultTargetName)` Sets the default target name, used if no other target is found.
`void`	`unregisterCommand(java.lang.String commandBeanName)` Unregisters a single command-to-target mapping.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - mapping
```
protected java.util.Dictionary mapping
```
    Contains the registered mappings between commands and targets. The key is the name of the command; the value is the name of the target.
  - targetTable
```
protected java.util.Hashtable targetTable
```
    Contains active targets. The key is the name of the target; the value is the target object.
  - defaultTargetName
```
protected java.lang.String defaultTargetName
```
    The default target name, used if no other target is found.
  - defaultTarget
```
protected transient CommandTarget defaultTarget
```
    The default target object, used if no other target is found.
- Constructor Detail
  - TargetPolicyDefault
```
public TargetPolicyDefault()
```
- Method Detail
  - getCommandTarget
```
public CommandTarget getCommandTarget(TargetableCommand command)
```
    The getCommandTarget() method implements the method in the TargetPolicy interface. This implementation uses the following ordered steps for determining the target that to be returned for a given command. It stops when it finds a target.
    1. If the command contains a target object, use it.
    2. If the command contains a name for a target, use it.
    3. If there is a mapping registered on the TargetPolicyDefault object between the command and a target, use it.
    4. If there is a default target name defined on the TargetPolicyDefault object, use it.
    5. Return null if no target can be found.
    Specified by:
    
    getCommandTarget in interface TargetPolicy
    
    Parameters:
    command - The TargetableCommand whose CommandTarget is needed.
    
    Returns:
    The CommandTarget for the command.
  - listMappings
```
public java.util.Dictionary listMappings()
```
    Lists all the command-to-target mappings.
    
    Returns:
    A Dictionary of mappings between command names and target names. The key is the name of the command; the value is the name of the target.
  - registerCommand
```
public void registerCommand(java.lang.String commandBeanName,
                   java.lang.String targetBeanName)
```
    Registers a single command-to-target mapping.
    
    Parameters:
    commandBeanName - The name of the command.
    targetBeanName - The name of the target.
  - setDefaultTargetName
```
public void setDefaultTargetName(java.lang.String defaultTargetName)
```
    Sets the default target name, used if no other target is found. This implementation uses the LocalTarget class as the default target name.
    
    Parameters:
    defaultTargetName - The name of the default target.
  - unregisterCommand
```
public void unregisterCommand(java.lang.String commandBeanName)
```
    Unregisters a single command-to-target mapping.
    
    Parameters:
    commandBeanName - The name of the command.

Methods inherited from class java.lang.Object

mapping

targetTable

defaultTargetName

defaultTarget

TargetPolicyDefault

getCommandTarget

listMappings

registerCommand

setDefaultTargetName

unregisterCommand