com.sap.conn.jco
Interface JCoListMetaData

All Superinterfaces:
java.lang.Cloneable, JCoMetaData, java.io.Serializable

public interface JCoListMetaData
extends JCoMetaData

Encapsulates the metadata of either a parameter list, a request, or a response. Each metadata element describes a field of these list oriented data containers in terms of name, type, length, etc. JCoListMetadata objects are mainly used to create parameter lists of a certain layout. JCoListMetadata contains all the metadata, which is specific to parameter lists.

See Also:
JCoParameterList, JCoRequest, JCoResponse

Field Summary
static int CHANGING_PARAMETER
          Flag indicating an export parameter.
static int EXPORT_PARAMETER
          Flag indicating an export parameter.
static int IMPORT_PARAMETER
          Flag indicating an import parameter.
static int OPTIONAL_PARAMETER
          Flag indicating an optional parameter.
 
Fields inherited from interface com.sap.conn.jco.JCoMetaData
TYPE_ABAPOBJECT, TYPE_BCD, TYPE_BOX, TYPE_BYTE, TYPE_CHAR, TYPE_DATE, TYPE_DECF16, TYPE_DECF34, TYPE_EXCEPTION, TYPE_FLOAT, TYPE_GENERIC_BOX, TYPE_INT, TYPE_INT1, TYPE_INT2, TYPE_INVALID, TYPE_ITAB, TYPE_NUM, TYPE_STRING, TYPE_STRUCTURE, TYPE_TABLE, TYPE_TIME, TYPE_XSTRING, UNINITIALIZED
 
Method Summary
 void add(java.lang.String name, int type, int nucByteLength, int ucByteLength, int flags)
          Adds a new scalar field descriptor to the metadata object.
 void add(java.lang.String name, int type, int nucByteLength, int ucByteLength, int decimals, java.lang.String defaults, java.lang.String description, int flags, java.lang.Object tabMetaData, JCoExtendedFieldMetaData extended)
          Adds a new field descriptor to the metadata object.
 void add(java.lang.String name, int type, int nucByteLength, int ucByteLength, int decimals, java.lang.String defaults, java.lang.String description, int flags, java.lang.Object tabMetaData, java.lang.String recordFieldName, JCoExtendedFieldMetaData extended)
          Adds a new field descriptor to the metadata object.
 void add(java.lang.String name, int type, JCoRecordMetaData recordMetaData, int flags)
          Adds a new complex field descriptor to the metadata object.
Complex fields are structures and tables.
 java.lang.String getDefault(int index)
          Returns the default value of the data field at the specified index.
 java.lang.String getDefault(java.lang.String fieldName)
          Returns the default value for the field with the specified name.
 java.lang.String getRecordFieldName(int index)
          If the parameter is defined by referencing a field in a table or structure, the name of this field for the parameter field at the specified index is returned, null otherwise.
 java.lang.String getRecordFieldName(java.lang.String fieldName)
          If the parameter is defined by referencing a field in a table or structure, the name of this field for the parameter field with the specified name is returned, null otherwise.
 boolean isChanging(int index)
          Checks whether the field at the specified index is a changing parameter.
 boolean isChanging(java.lang.String fieldName)
          Checks whether the field with the specified name is a changing parameter.
 boolean isException(int index)
          Checks whether this field is an exception.
 boolean isException(java.lang.String fieldName)
          Checks whether this field with the specified name is an exception.
 boolean isExport(int index)
          Checks whether the field at the specified index is an export parameter.
 boolean isExport(java.lang.String fieldName)
          Checks whether the field with the specified name is an export parameter.
 boolean isImport(int index)
          Checks whether the field at the specified index is an import parameter.
 boolean isImport(java.lang.String fieldName)
          Checks whether the field with the specified name is an import parameter.
 boolean isOptional(int index)
          Checks whether the field at the specified index is an optional parameter.
 boolean isOptional(java.lang.String fieldName)
          Checks whether the field with the specified name is an optional parameter.
 
Methods inherited from interface com.sap.conn.jco.JCoMetaData
getByteLength, getByteLength, getClassNameOfField, getClassNameOfField, getDecimals, getDecimals, getDescription, getDescription, getExtendedFieldMetaData, getExtendedFieldMetaData, getFieldCount, getLength, getLength, getName, getName, getRecordMetaData, getRecordMetaData, getRecordTypeName, getRecordTypeName, getType, getType, getTypeAsString, getTypeAsString, getUnicodeByteLength, getUnicodeByteLength, hasField, indexOf, isAbapObject, isAbapObject, isLocked, isNestedType1Structure, isNestedType1Structure, isStructure, isStructure, isTable, isTable, lock, setName
 

Field Detail

OPTIONAL_PARAMETER

static final int OPTIONAL_PARAMETER
Flag indicating an optional parameter.

See Also:
Constant Field Values

IMPORT_PARAMETER

static final int IMPORT_PARAMETER
Flag indicating an import parameter.

See Also:
Constant Field Values

EXPORT_PARAMETER

static final int EXPORT_PARAMETER
Flag indicating an export parameter.

See Also:
Constant Field Values

CHANGING_PARAMETER

static final int CHANGING_PARAMETER
Flag indicating an export parameter.

See Also:
Constant Field Values
Method Detail

add

void add(java.lang.String name,
         int type,
         int nucByteLength,
         int ucByteLength,
         int flags)
Adds a new scalar field descriptor to the metadata object.

Parameters:
name - field name for identifying this data field
type - field datatype
nucByteLength - data field length in bytes for non-Unicode layout
ucByteLength - data field length in bytes for Unicode layout
flags - bit-vector for additional attributes of the field. The vector can be ORed together from
  • IMPORT_PARAMETER - if the field is an import parameter
  • EXPORT_PARAMETER - if the field is an export parameter
  • CHANGING_PARAMETER - if the field is a changing parameter
  • OPTIONAL_PARAMETER - if the field is an optional parameter

add

void add(java.lang.String name,
         int type,
         JCoRecordMetaData recordMetaData,
         int flags)
Adds a new complex field descriptor to the metadata object.
Complex fields are structures and tables.

Parameters:
name - field name for identifying this data field
type - field datatype
recordMetaData - the metadata for the structure or table
flags - bit-vector for additional attributes of the field. The vector can be ORed together from
  • IMPORT_PARAMETER - if the field is an import parameter
  • EXPORT_PARAMETER - if the field is an export parameter
  • CHANGING_PARAMETER - if the field is a changing parameter
  • OPTIONAL_PARAMETER - if the field is an optional parameter

add

void add(java.lang.String name,
         int type,
         int nucByteLength,
         int ucByteLength,
         int decimals,
         java.lang.String defaults,
         java.lang.String description,
         int flags,
         java.lang.Object tabMetaData,
         JCoExtendedFieldMetaData extended)
Adds a new field descriptor to the metadata object.

Parameters:
name - field name for identifying this data field
type - field datatype
nucByteLength - data field length in bytes for non-Unicode layout
ucByteLength - data field length in bytes for Unicode layout
decimals - data field number of decimals (only necessary for the data types TYPE_BCD and TYPE_FLOAT)
defaults - data field default value
description - descriptive text of the data field
flags - bit-vector for additional attributes of the field. The vector can be ORed together from
  • IMPORT_PARAMETER - if the field is an import parameter
  • EXPORT_PARAMETER - if the field is an export parameter
  • CHANGING_PARAMETER - if the field is a changing parameter
  • OPTIONAL_PARAMETER - if the field is an optional parameter
tabMetaData - metadata for a complex field, if the field is a structure or a table
extended - extended metadata for this field or null if none is available

add

void add(java.lang.String name,
         int type,
         int nucByteLength,
         int ucByteLength,
         int decimals,
         java.lang.String defaults,
         java.lang.String description,
         int flags,
         java.lang.Object tabMetaData,
         java.lang.String recordFieldName,
         JCoExtendedFieldMetaData extended)
Adds a new field descriptor to the metadata object.

Parameters:
name - field name for identifying this data field
type - field datatype
nucByteLength - data field length in bytes for non-Unicode layout
ucByteLength - data field length in bytes for Unicode layout
decimals - data field number of decimals (only necessary for the data types TYPE_BCD and TYPE_FLOAT)
defaults - data field default value
description - descriptive text of the data field
flags - bit-vector for additional attributes of the field. The vector can be ORed together from
  • IMPORT_PARAMETER - if the field is an import parameter
  • EXPORT_PARAMETER - if the field is an export parameter
  • CHANGING_PARAMETER - if the field is a changing parameter
  • OPTIONAL_PARAMETER - if the field is an optional parameter
tabMetaData - metadata for a complex field, if the field is a structure or a table
recordFieldName - associated field name in a referenced table or structure metadata
extended - extended metadata for this field or null if none is available

isException

boolean isException(int index)
Checks whether this field is an exception.

Parameters:
index - the index of the field
Returns:
true if the specified field is an exception, false otherwise

isException

boolean isException(java.lang.String fieldName)
Checks whether this field with the specified name is an exception.

Parameters:
fieldName - the name of the field
Returns:
true if the specified field is an exception, false otherwise
Throws:
JCoRuntimeException - with group JCO_ERROR_FIELD_NOT_FOUND if a field with this name does not exist

getDefault

java.lang.String getDefault(int index)
Returns the default value of the data field at the specified index.

Parameters:
index - the index of the field
Returns:
data field default value

getDefault

java.lang.String getDefault(java.lang.String fieldName)
Returns the default value for the field with the specified name.

Parameters:
fieldName - the name of the field
Returns:
data field default value
Throws:
JCoRuntimeException - with group JCO_ERROR_FIELD_NOT_FOUND if a field with this name does not exist

getRecordFieldName

java.lang.String getRecordFieldName(int index)
If the parameter is defined by referencing a field in a table or structure, the name of this field for the parameter field at the specified index is returned, null otherwise. In the first case getRecordTypeName(index) would contain the name of the enclosing record.

Parameters:
index - the index of the parameter field
Returns:
referenced record field name
See Also:
JCoMetaData.getRecordTypeName(int)

getRecordFieldName

java.lang.String getRecordFieldName(java.lang.String fieldName)
If the parameter is defined by referencing a field in a table or structure, the name of this field for the parameter field with the specified name is returned, null otherwise. In the first case getRecordTypeName(fieldName) would contain the name of the enclosing record.

Parameters:
fieldName - the name of the parameter field
Returns:
referenced record field name
Throws:
JCoRuntimeException - with group JCO_ERROR_FIELD_NOT_FOUND if a field with this name does not exist
See Also:
JCoMetaData.getRecordTypeName(String)

isOptional

boolean isOptional(int index)
Checks whether the field at the specified index is an optional parameter.

Parameters:
index - the index of the field
Returns:
true if the specified field is an optional parameter, false otherwise

isOptional

boolean isOptional(java.lang.String fieldName)
Checks whether the field with the specified name is an optional parameter.

Parameters:
fieldName - the name of the field
Returns:
true if the specified field is an optional parameter, false otherwise
Throws:
JCoRuntimeException - with group JCO_ERROR_FIELD_NOT_FOUND if a field with this name does not exist

isImport

boolean isImport(int index)
Checks whether the field at the specified index is an import parameter.

Parameters:
index - the index of the field
Returns:
true if the specified field is an import parameter, false otherwise

isImport

boolean isImport(java.lang.String fieldName)
Checks whether the field with the specified name is an import parameter.

Parameters:
fieldName - the name of the field
Returns:
true if the specified field is an import parameter, false otherwise
Throws:
JCoRuntimeException - with group JCO_ERROR_FIELD_NOT_FOUND if a field with this name does not exist

isExport

boolean isExport(int index)
Checks whether the field at the specified index is an export parameter.

Parameters:
index - the index of the field
Returns:
true if the specified field is an export parameter, false otherwise

isExport

boolean isExport(java.lang.String fieldName)
Checks whether the field with the specified name is an export parameter.

Parameters:
fieldName - the name of the field
Returns:
true if the specified field is an export parameter, false otherwise
Throws:
JCoRuntimeException - with group JCO_ERROR_FIELD_NOT_FOUND if a field with this name does not exist

isChanging

boolean isChanging(int index)
Checks whether the field at the specified index is a changing parameter.

Parameters:
index - the index of the field
Returns:
true if the specified field is a changing parameter, false otherwise

isChanging

boolean isChanging(java.lang.String fieldName)
Checks whether the field with the specified name is a changing parameter.

Parameters:
fieldName - the name of the field
Returns:
true if the specified field is a changing parameter, false otherwise
Throws:
JCoRuntimeException - with group JCO_ERROR_FIELD_NOT_FOUND if a field with this name does not exist


Copyright © 2008-2016 SAP SE. All Rights Reserved.