org.snmp4j.util
Interface VariableTextFormat

All Known Implementing Classes:
SimpleVariableTextFormat

public interface VariableTextFormat

The VariableTextFormat provides a textual representation of SNMP Variables, in dependence of their associated (instance) OID.

Since:
1.10
Version:
1.10
Author:
Frank Fock

Method Summary
 java.lang.String format(OID instanceOID, Variable variable, boolean withOID)
          Returns a textual representation of the supplied variable against the optionally supplied instance OID.
 Variable parse(int smiSyntax, java.lang.String text)
          Parses a textual representation of a variable against a SMI type.
 Variable parse(OID classOrInstanceOID, java.lang.String text)
          Parses a textual representation of a variable against its associated OBJECT-TYPE OID.
 VariableBinding parseVariableBinding(java.lang.String text)
          Parses a textual representation of a variable binding.
 

Method Detail

format

java.lang.String format(OID instanceOID,
                        Variable variable,
                        boolean withOID)
Returns a textual representation of the supplied variable against the optionally supplied instance OID.

Parameters:
instanceOID - the instance OID variable is associated with. If null the formatting cannot take any MIB specification of the variable into account and has to format it based on its type only.
variable - the variable to format.
withOID - if true the instanceOID should be included in the textual representation to form a VariableBinding representation.
Returns:
the textual representation.

parseVariableBinding

VariableBinding parseVariableBinding(java.lang.String text)
                                     throws java.text.ParseException
Parses a textual representation of a variable binding.

Parameters:
text - a textual representation of the variable binding.
Returns:
the new VariableBinding instance.
Throws:
java.text.ParseException - if the variable binding cannot be parsed successfully.

parse

Variable parse(OID classOrInstanceOID,
               java.lang.String text)
               throws java.text.ParseException
Parses a textual representation of a variable against its associated OBJECT-TYPE OID.

Parameters:
classOrInstanceOID - the instance OID variable is associated with. Must not be null.
text - a textual representation of the variable.
Returns:
the new Variable instance.
Throws:
java.text.ParseException - if the variable cannot be parsed successfully.

parse

Variable parse(int smiSyntax,
               java.lang.String text)
               throws java.text.ParseException
Parses a textual representation of a variable against a SMI type.

Parameters:
smiSyntax - the SMI syntax identifier identifying the target Variable.
text - a textual representation of the variable.
Returns:
the new Variable instance.
Throws:
java.text.ParseException - if the variable cannot be parsed successfully.

Copyright 2005-2010 Frank Fock (SNMP4J.org)

Copyright © 2011 SNMP4J.org. All Rights Reserved.