TelnetTask (Apache Ant API)
Description: declaration: package: org.apache.tools.ant.taskdefs.optional.net, class: TelnetTask

Package org.apache.tools.ant.taskdefs.optional.net

# Class TelnetTask

java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.Task
org.apache.tools.ant.taskdefs.optional.net.TelnetTask

All Implemented Interfaces:
  `Cloneable`

public class TelnetTask extends Task
Automates the telnet protocol.

- ## Nested Class Summary

  Nested Classes
  Modifier and Type
  Class
  Description
  `class`
  `TelnetTask.AntTelnetClient`
  This class handles the abstraction of the telnet protocol.
  `class`
  `TelnetTask.TelnetRead`
  Reads the output from the connected server until the required string is found or we time out.
  `class`
  `TelnetTask.TelnetSubTask`
  This class is the parent of the Read and Write tasks.
  `class`
  `TelnetTask.TelnetWrite`
  Sends text to the connected server

- ## Field Summary

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

  `target, taskName, taskType, wrapper`

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

  `description, location, project`

- ## Constructor Summary

  Constructors
  Constructor
  Description
  `TelnetTask()`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `TelnetTask.TelnetSubTask`
  `createRead()`
  A string to wait for from the server.
  `TelnetTask.TelnetSubTask`
  `createWrite()`
  Add text to send to the server A subTask <write> tag was found.
  `void`
  `execute()`
  Verify that all parameters are included.
  `void`
  `setInitialCR(boolean b)`
  send a carriage return after connecting; optional, defaults to false.
  `void`
  `setPassword(String p)`
  Set the the login password to use required if `userid` is set.
  `void`
  `setPort(int p)`
  Set the tcp port to connect to; default is 23.
  `void`
  `setServer(String m)`
  Set the hostname or address of the remote server.
  `void`
  `setTimeout(Integer i)`
  set a default timeout in seconds to wait for a response, zero means forever (the default)
  `void`
  `setUserid(String u)`
  Set the the login id to use on the server; required if `password` is set.

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

  `bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType`

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

  `clone, getDescription, getLocation, getProject, setDescription, setLocation, setProject`

  ### Methods inherited from class java.lang.Object

  `equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## Constructor Details

  - ### TelnetTask

    public TelnetTask()

- ## Method Details

  - ### execute

    public void execute() throws BuildException
    Verify that all parameters are included. Connect and possibly login Iterate through the list of Reads and writes
    Overrides:
      `execute` in class `Task`
    Throws:
      `BuildException` - on error

  - ### setUserid

    public void setUserid(String u)
    Set the the login id to use on the server; required if `password` is set.
    Parameters:
      `u` - a `String` value

  - ### setPassword

    public void setPassword(String p)
    Set the the login password to use required if `userid` is set.
    Parameters:
      `p` - a `String` value

  - ### setServer

    public void setServer(String m)
    Set the hostname or address of the remote server.
    Parameters:
      `m` - a `String` value

  - ### setPort

    public void setPort(int p)
    Set the tcp port to connect to; default is 23.
    Parameters:
      `p` - an `int` value

  - ### setInitialCR

    public void setInitialCR(boolean b)
    send a carriage return after connecting; optional, defaults to false.
    Parameters:
      `b` - a `boolean` value

  - ### setTimeout

    public void setTimeout(Integer i)
    set a default timeout in seconds to wait for a response, zero means forever (the default)
    Parameters:
      `i` - an `Integer` value

  - ### createRead

    public TelnetTask.TelnetSubTask createRead()
    A string to wait for from the server. A subTask <read> tag was found. Create the object, Save it in our list, and return it.
    Returns:
      a read telnet sub task

  - ### createWrite

    public TelnetTask.TelnetSubTask createWrite()
    Add text to send to the server A subTask <write> tag was found. Create the object, Save it in our list, and return it.
    Returns:
      a write telnet sub task