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:
  `java.lang.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​(java.lang.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​(java.lang.String m)` | Set the hostname or address of the remote server.
  `void` | `setTimeout​(java.lang.Integer i)` | set a default timeout in seconds to wait for a response, zero means forever (the default)
  `void` | `setUserid​(java.lang.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​(java.lang.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​(java.lang.String p)
    Set the the login password to use required if `userid` is set.
    Parameters:
      `p` - a `String` value

  - ### setServer

    public void setServer​(java.lang.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​(java.lang.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