net.wimpi.modbus.io

Class ModbusUDPTransaction

java.lang.Object

net.wimpi.modbus.io.ModbusUDPTransaction

All Implemented Interfaces:

ModbusTransaction

public class ModbusUDPTransaction
extends Object
implements ModbusTransaction

Class implementing the ModbusTransaction interface for the UDP transport mechanism.

Version:

1.2

Author:

Dieter Wimberger

Constructor Summary

Constructors

Constructor and Description
ModbusUDPTransaction() Constructs a new ModbusUDPTransaction instance.
ModbusUDPTransaction(ModbusRequest request) Constructs a new ModbusUDPTransaction instance with a given ModbusRequest to be send when the transaction is executed.
ModbusUDPTransaction(UDPMasterConnection con) Constructs a new ModbusUDPTransaction instance with a given ModbusUDPConnection to be used for transactions.
ModbusUDPTransaction(UDPTerminal terminal) Constructs a new ModbusUDPTransaction instance with a given UDPTerminal to be used for transactions.

Method Summary

Modifier and Type	Method and Description
protected void	checkValidity() Checks the validity of the transaction, by checking if the values of the response correspond to the values of the request.
void	execute() Executes this ModbusTransaction.
ModbusRequest	getRequest() Returns the ModbusRequest instance associated with this ModbusTransaction.
ModbusResponse	getResponse() Returns the ModbusResponse instance associated with this ModbusTransaction.
int	getRetries() Returns the amount of retries for opening the connection for executing the transaction.
int	getTransactionID() Returns the actual transaction identifier of this ModbusTransaction.
boolean	isCheckingValidity() Tests whether the validity of a transaction will be checked.
void	setCheckingValidity(boolean b) Sets the flag that controls whether the validity of a transaction will be checked.
void	setRequest(ModbusRequest req) Sets the ModbusRequest for this ModbusTransaction.
void	setRetries(int num) Set the amount of retries for opening the connection for executing the transaction.
void	setTerminal(UDPTerminal terminal) Sets the terminal on which this ModbusTransaction should be executed.

Methods inherited from class java.lang.Object

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

Constructor Detail

ModbusUDPTransaction

public ModbusUDPTransaction()

Constructs a new ModbusUDPTransaction instance.

ModbusUDPTransaction

public ModbusUDPTransaction(ModbusRequest request)

Constructs a new ModbusUDPTransaction instance with a given ModbusRequest to be send when the transaction is executed.

Parameters:

request - a ModbusRequest instance.

ModbusUDPTransaction

public ModbusUDPTransaction(UDPTerminal terminal)

Constructs a new ModbusUDPTransaction instance with a given UDPTerminal to be used for transactions.

Parameters:

terminal - a UDPTerminal instance.

ModbusUDPTransaction

public ModbusUDPTransaction(UDPMasterConnection con)

Constructs a new ModbusUDPTransaction instance with a given ModbusUDPConnection to be used for transactions.

Parameters:

con - a ModbusUDPConnection instance.

Method Detail

setTerminal

public void setTerminal(UDPTerminal terminal)

Sets the terminal on which this ModbusTransaction should be executed.

Parameters:

terminal - a UDPSlaveTerminal.

setRequest

public void setRequest(ModbusRequest req)

Description copied from interface: ModbusTransaction

Sets the ModbusRequest for this ModbusTransaction.

The related ModbusResponse is acquired from the passed in ModbusRequest instance.

Specified by:

setRequest in interface ModbusTransaction

Parameters:

req - a ModbusRequest.

getRequest

public ModbusRequest getRequest()

Description copied from interface: ModbusTransaction

Returns the ModbusRequest instance associated with this ModbusTransaction.

Specified by:

getRequest in interface ModbusTransaction

Returns:

the associated ModbusRequest instance.

getResponse

public ModbusResponse getResponse()

Description copied from interface: ModbusTransaction

Returns the ModbusResponse instance associated with this ModbusTransaction.

Specified by:

getResponse in interface ModbusTransaction

Returns:

the associated ModbusRequest instance.

getTransactionID

public int getTransactionID()

Description copied from interface: ModbusTransaction

Returns the actual transaction identifier of this ModbusTransaction. The identifier is a 2-byte (short) non negative integer value valid in the range of 0-65535.

Specified by:

getTransactionID in interface ModbusTransaction

Returns:

the actual transaction identifier as int.

setCheckingValidity

public void setCheckingValidity(boolean b)

Description copied from interface: ModbusTransaction

Sets the flag that controls whether the validity of a transaction will be checked.

Specified by:

setCheckingValidity in interface ModbusTransaction

Parameters:

b - true if checking validity, false otherwise.

isCheckingValidity

public boolean isCheckingValidity()

Description copied from interface: ModbusTransaction

Tests whether the validity of a transaction will be checked.

Specified by:

isCheckingValidity in interface ModbusTransaction

Returns:

true if checking validity, false otherwise.

getRetries

public int getRetries()

Description copied from interface: ModbusTransaction

Returns the amount of retries for opening the connection for executing the transaction.

Specified by:

getRetries in interface ModbusTransaction

Returns:

the amount of retries as int.

setRetries

public void setRetries(int num)

Description copied from interface: ModbusTransaction

Set the amount of retries for opening the connection for executing the transaction.

Specified by:

setRetries in interface ModbusTransaction

Parameters:

num - the amount of retries as int.

execute

public void execute()
             throws ModbusIOException,
                    ModbusSlaveException,
                    ModbusException

Description copied from interface: ModbusTransaction

Executes this ModbusTransaction. Locks the ModbusTransport for sending the ModbusRequest and reading the related ModbusResponse. If reconnecting is activated the connection will be opened for the transaction and closed afterwards.

Specified by:

execute in interface ModbusTransaction

Throws:

ModbusException - if an I/O error occurs, or the response is a modbus protocol exception.

ModbusIOException

ModbusSlaveException

checkValidity

protected void checkValidity()
                      throws ModbusException

Checks the validity of the transaction, by checking if the values of the response correspond to the values of the request. Use an override to provide some checks, this method will only return.

Throws:

ModbusException - if this transaction has not been valid.