src.com.ibm.as400.data.ProgramCallDocument Maven / Gradle / Ivy
///////////////////////////////////////////////////////////////////////////////
//
// JTOpen (IBM Tolbox for Java - OSS version)
//
// Filename: ProgramCallDocument.java
//
// The source code contained herein is licensed under the IBM Public License
// Version 1.0, which has been approved by the Open Source Initiative.
// Copyright (C) 1997-2004 International Business Machines Corporation and
// others. All rights reserved.
//
///////////////////////////////////////////////////////////////////////////////
package com.ibm.as400.data;
import com.ibm.as400.access.AS400;
import com.ibm.as400.access.AS400Message;
import com.ibm.as400.access.AS400SecurityException;
import com.ibm.as400.access.BidiStringType;
import com.ibm.as400.access.ObjectDoesNotExistException;
import com.ibm.as400.access.ErrorCompletingRequestException;
import com.ibm.as400.access.ExtendedIllegalArgumentException;
import com.ibm.as400.access.SystemProperties;
import com.ibm.as400.access.Trace; // @C4A
import com.ibm.as400.access.ProgramCall;
import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileOutputStream;
import java.io.InputStream;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.ObjectOutputStream;
import java.io.Serializable;
import java.io.StreamCorruptedException;
import java.io.ByteArrayOutputStream; //@E1A
import java.io.ByteArrayInputStream; //@E1A
import java.io.OutputStream; //@E1A
import java.io.InputStreamReader; //@E1A
import java.io.LineNumberReader; //@E1A
import java.util.MissingResourceException;
import java.util.zip.GZIPInputStream;
import javax.xml.transform.TransformerException; //@E1A
import org.xml.sax.SAXException; //@E1A
/**
* XML Document based program call.
*
* The ProgramCallDocument class uses a Program Call Markup Language (PCML) document to
* call IBM i system programs.
* PCML is an XML language for describing the input and output parameters
* to the IBM i system program.
*
* This class parses a PCML document and allows the application to call
* IBM i system programs described in the PCML document.
*
* Command Line Interface
* The command line interface may be used to serialize
* PCML document definitions. Note that XPCML documents cannot
* be serialized.
*
* java com.ibm.as400.data.ProgramCallDocument
* -serialize
* PCML document name
*
* Options:
*
* - -serialize
*
- Parses the PCML document and creates a serialized version of the document.
* The name of the serialized file will match the document name, and the file extension will be
*
.pcml.ser (lowercase).
* - PCML document name
*
- The fully-qualified resource name of the PCML document
* which defines the program interface.
*
*/
public class ProgramCallDocument implements Serializable, Cloneable
{ // @C1C @C3C
static final long serialVersionUID = -1836686444079106483L; // @C1A
/**
* Constant indicating a serialized PCML or XPCML document is being streamed.
* @see #ProgramCallDocument(AS400,String,InputStream,ClassLoader,InputStream,int)
**/
public static final int SERIALIZED = 0;
/**
* Constant indicating a source PCML document is being streamed.
* @see #ProgramCallDocument(AS400,String,InputStream,ClassLoader,InputStream,int)
**/
public static final int SOURCE_PCML = 1;
/**
* Constant indicating a source XPCML document is being streamed.
* @see #ProgramCallDocument(AS400,String,InputStream,ClassLoader,InputStream,int)
**/
public static final int SOURCE_XPCML = 2;
private AS400 m_as400;
private PcmlDocument m_pcmlDoc;
static boolean exceptionIfParseError_;
private int m_timeOut = 0; //@Y6A
static
{
String property = null;
try {
property = SystemProperties.getProperty(SystemProperties.THROW_SAX_EXCEPTION_IF_PARSE_ERROR);
}
catch (Throwable t) {}
if (property == null) { // Property not set.
exceptionIfParseError_ = false;
}
else if (property.trim().equalsIgnoreCase("true")) {
exceptionIfParseError_ = true;
}
else {
exceptionIfParseError_ = false;
}
}
/**
Constructs a ProgramCallDocument object.
The PCML or XPCML document resource will be loaded from the classpath.
If the document is a PCML document, the classpath will first be searched for a serialized resource.
XPCML documents cannot be serialized.
If a serialized resource is not found, the classpath will be
searched for a PCML or XPCML source file.
@param sys The system on which to run the program.
@param docName The document resource name of the PCML document for the programs to be called.
All PCML-related file extensions are assumed to be lowercase (for example, .pcml or .pcml.ser).
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml"
@exception PcmlException when the specified PCML document cannot be found
*/
public ProgramCallDocument(AS400 sys, String docName)
throws PcmlException
{
if (sys == null) warnNull("sys");
if (docName == null) warnNull("docName");
m_as400 = sys;
m_pcmlDoc = loadPcmlDocument(docName, null,null); // @C8C @E1C
if (m_as400 != null) m_pcmlDoc.setAs400(m_as400);
}
/**
Constructs a ProgramCallDocument object.
The XPCML document resource will be loaded from the classpath and parsed using
the XML schema definitions provided in the input XSD stream.
@param sys The system on which to run the program.
@param docName The document resource name of the PCML document for the programs to be called.
All PCML-related file extensions are assumed to be lowercase (for example, .pcml or .pcml.ser).
@param xsdStream An input stream that contains XML schema definitions that extend XPCML.
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml"
@exception PcmlException when the specified PCML document cannot be found
*/
public ProgramCallDocument(AS400 sys, String docName, InputStream xsdStream)
throws PcmlException
{
if (sys == null) warnNull("sys");
if (docName == null) warnNull("docName");
m_as400 = sys;
m_pcmlDoc = loadPcmlDocument(docName, null,xsdStream); // @C8C
if (m_as400 != null) m_pcmlDoc.setAs400(m_as400);
}
/**
Constructs a ProgramCallDocument object.
The PCML or XPCML document resource will be loaded from the classpath.
If the document is a PCML document, the classpath will first be searched for a serialized resource.
XPCML documents cannot be serialized.
If a serialized resource is not found, the classpath will be
searched for a PCML or XPCML source file.
@param sys The system on which to run the program.
@param docName The document resource name of the PCML document for the programs to be called.
All PCML-related file extensions are assumed to be lowercase (for example, .pcml or .pcml.ser).
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml"
@param loader The ClassLoader that will be used when loading the specified document resource.
@exception PcmlException when the specified PCML document cannot be found
*/
public ProgramCallDocument(AS400 sys, String docName, ClassLoader loader) // @C8A
throws PcmlException
{
if (sys == null) warnNull("sys");
if (docName == null) warnNull("docName");
m_as400 = sys; // @C8A
m_pcmlDoc = loadPcmlDocument(docName, loader,null); // @C8A
if (m_as400 != null) m_pcmlDoc.setAs400(m_as400); // @C8A
}
/**
Constructs a ProgramCallDocument object.
The PCML or XPCML document resource will be loaded from the classpath and parsed using
the XML schema definitions provided in the input XSD stream.
@param sys The system on which to run the program.
@param docName The document resource name of the PCML document for the programs to be called.
All PCML-related file extensions are assumed to be lowercase (for example, .pcml or .pcml.ser).
@param loader The ClassLoader that will be used when loading the specified document resource.
@param xsdStream An input stream that contains XML schema definitions that extend XPCML. This parameter can be null.
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml"
@exception PcmlException when the specified PCML document cannot be found
*/
public ProgramCallDocument(AS400 sys, String docName, ClassLoader loader, InputStream xsdStream) // @C8A
throws PcmlException
{
if (sys == null) warnNull("sys");
if (docName == null) warnNull("docName");
m_as400 = sys; // @C8A
m_pcmlDoc = loadPcmlDocument(docName, loader,xsdStream); // @C8A
if (m_as400 != null) m_pcmlDoc.setAs400(m_as400); // @C8A
}
/**
Constructs a ProgramCallDocument object.
The PCML or XPCML document resource will be read from the specified input stream, and parsed using
the XML schema definitions provided in the input XSD stream.
@param sys The system on which to run the program.
@param docName The document resource name of the PCML document for the programs to be called.
All PCML-related file extensions are assumed to be lowercase (for example, .pcml or .pcml.ser).
@param docStream The InputStream from which to read the contents of the document.
@param loader The ClassLoader that will be used when loading the DTD for PCML. This parameter can be null.
@param xsdStream An input stream that contains XML schema definitions that extend XPCML
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml". This parameter can be null.
@param type The type of data contained in docStream. Possible values are:
- {@link #SERIALIZED SERIALIZED} - The docStream contains a serialized PCML or XPCML document.
- {@link #SOURCE_PCML SOURCE_PCML} - The docStream contains a PCML document.
- {@link #SOURCE_XPCML SOURCE_XPCML} - The docStream contains an XPCML document.
@exception PcmlException when the specified PCML document cannot be found
*/
public ProgramCallDocument(AS400 sys, String docName, InputStream docStream, ClassLoader loader, InputStream xsdStream, int type)
throws PcmlException
{
if (sys == null) warnNull("sys");
if (docName == null) warnNull("docName");
if (type == ProgramCallDocument.SERIALIZED)
{
m_pcmlDoc = loadSerializedPcmlDocumentFromStream(docStream);
}
else if (type == ProgramCallDocument.SOURCE_PCML)
{
m_pcmlDoc = loadSourcePcmlDocumentFromStream(docName, docStream, loader, xsdStream, false);
}
else if (type == ProgramCallDocument.SOURCE_XPCML)
{
m_pcmlDoc = loadSourcePcmlDocumentFromStream(docName, docStream, loader, xsdStream, true);
}
else {
throw new ExtendedIllegalArgumentException("type (" + type + ")", ExtendedIllegalArgumentException.PARAMETER_VALUE_NOT_VALID);
}
m_as400 = sys;
if (m_as400 != null) m_pcmlDoc.setAs400(m_as400);
}
/**
Constructs a ProgramCallDocument object.
{@link #setSystem setSystem()} and {@link #setDocument setDocument()} must be called prior to using the object.
@exception PcmlException when the specified PCML document cannot be found
*/
public ProgramCallDocument()
throws PcmlException // @C1A
{ // @C1A
m_as400 = null; // @C1A
m_pcmlDoc = null; // @C1A
} // @C1A
/**
Constructs a ProgramCallDocument object.
{@link #setSystem setSystem()} must be called prior to using the object.
The PCML or XPCML document resource will be loaded from the classpath.
If the document is a PCML document, the classpath will first be searched for a serialized resource.
XPCML documents cannot be serialized.
If a serialized resource is not found, the classpath will be
searched for a PCML or XPCML source file.
@param docName The document resource name of the PCML document for the programs to be called.
All PCML-related file extensions are assumed to be lowercase (for example, .pcml or .pcml.ser).
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml"
@exception PcmlException when the specified PCML document cannot be found
*/
public ProgramCallDocument(String docName)
throws PcmlException
{
if (docName == null) {
throw new NullPointerException("docName");
}
m_pcmlDoc = loadPcmlDocument(docName, null,null);
}
/**
Constructs a ProgramCallDocument object.
{@link #setSystem setSystem()} must be called prior to using the object.
The PCML or XPCML document resource will be loaded from the classpath of the specified ClassLoader.
If the document is a PCML document, the classpath will first be searched for a serialized resource.
XPCML documents cannot be serialized.
If a serialized resource is not found, the classpath will be
searched for a PCML or XPCML source file.
@param docName The document resource name of the PCML document for the programs to be called.
@param loader The ClassLoader that will be used when loading the specified document resource.
* @throws XmlException
@exception PcmlException when the specified PCML document cannot be found
*/
public ProgramCallDocument(String docName, ClassLoader loader)
throws XmlException
{
if (docName == null) {
throw new NullPointerException("docName");
}
if (loader == null) {
throw new NullPointerException("loader");
}
m_pcmlDoc = loadPcmlDocument(docName, loader, null);
}
/**
Clones the ProgramCallDocument and the objects contained in it.
{@link #setSystem setSystem()} and {@link #setDocument setDocument()} must be called prior to using the object.
*/
public Object clone()
{ // @C3A
ProgramCallDocument newPcml = null; // @C3A
try // @C3A
{ // @C3A
newPcml = (ProgramCallDocument) super.clone(); // @C3A
if (m_pcmlDoc != null) // @C3A
newPcml.m_pcmlDoc = (PcmlDocument) m_pcmlDoc.clone(); // @C3A
} // @C3A
catch (CloneNotSupportedException e) // @C3A
{} // @C3A
return newPcml; // @C3A
} // @C3A
// Custom serialization
private void writeObject(ObjectOutputStream out)
throws IOException // @C1A
{ // @C1A
synchronized (this) // @C1A
{ // @C1A
if (m_pcmlDoc != null) // @C1A
{ // @C1A
m_pcmlDoc.setSerializingWithData(true); // @C1A
} // @C1A
// Perform default serialization
out.defaultWriteObject(); // @C1A
} // end of synchronized code // @C1A
} // @C1A
/**
* Provides a command line interface to ProgramCallDocument. See the class description.
* Note that XPCML documents cannot be serialized.
* @param args
*
*/
public static void main(String[] args)
{
PcmlDocument pd = null;
System.setErr(System.out);
final String errMsg = SystemResourceFinder.format(DAMRI.PCD_ARGUMENTS);
if (args.length == 2)
{
if (!args[0].equalsIgnoreCase("-SERIALIZE"))
{
System.out.println(errMsg);
System.exit(-1);
}
// Load the document from source (previously serialized documents are ignored)
try
{
pd = loadSourcePcmlDocument(args[1], null,null); // @C8C
}
catch (PcmlException e)
{
System.out.println(e.getLocalizedMessage());
System.exit(-1);
}
// Save the document as a serialized file
try
{
savePcmlDocument(pd);
}
catch (Exception e)
{
System.out.println(e.getLocalizedMessage());
System.exit(-1);
}
}
else
{
System.out.println(errMsg);
System.exit(-1);
}
}
/**
Calls the named program.
@param name The name of the <program> element in the PCML document.
* @return true if the call is successful
@exception PcmlException
If an error occurs.
*/
public boolean callProgram(String name)
throws PcmlException
{
try
{
m_pcmlDoc.setTimeOut(m_timeOut); //@Y6A
return m_pcmlDoc.callProgram(name);
}
catch (AS400SecurityException e)
{
if (Trace.isTraceErrorOn()) // @C4A
e.printStackTrace(Trace.getPrintWriter()); // @C4C
PcmlException pe = new PcmlException(e);
throw pe;
}
catch (ObjectDoesNotExistException e)
{
if (Trace.isTraceErrorOn()) // @C4A
e.printStackTrace(Trace.getPrintWriter()); // @C4C
PcmlException pe = new PcmlException(e);
throw pe;
}
catch (InterruptedException e)
{
if (Trace.isTraceErrorOn()) // @C4A
e.printStackTrace(Trace.getPrintWriter()); // @C4C
PcmlException pe = new PcmlException(e);
throw pe;
}
catch (ErrorCompletingRequestException e)
{
if (Trace.isTraceErrorOn()) // @C4A
e.printStackTrace(Trace.getPrintWriter()); // @C4C
PcmlException pe = new PcmlException(e);
throw pe;
}
catch (IOException e)
{
if (Trace.isTraceErrorOn()) // @C4A
e.printStackTrace(Trace.getPrintWriter()); // @C4C
throw new PcmlException(e);
}
}
/**
Returns an "errno" value for the named service program element.
The named program element must be defined as a service program entrypoint.
The value returned is the "errno" value resulting from the most recent
call to the program. If the program has not been called, zero is returned.
@return The integer "errno" value for the named service program element.
@param name The name of the <program> element in the PCML document.
@exception PcmlException
If an error occurs.
*/
public int getErrno(String name)
throws PcmlException // @B1A
{ // @B1A
return m_pcmlDoc.getErrno(name); // @B1A
} // @B1A
/**
Returns a Descriptor for the specified PCML document.
The PCML document resource will be loaded from the classpath.
The classpath will first be searched for a serialized resource.
If a serialized resource is not found, the classpath will be
searched for a PCML source file.
@param docName The document resource name of the PCML document for which the Descriptor is returned.
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml"
@return The Descriptor for the <pcml> element of the named PCML file.
@exception PcmlException when the specified PCML document cannot be found
*/
public static Descriptor getDescriptor(String docName)
throws PcmlException // @C5A
{
PcmlDocument pd = null;
pd = loadPcmlDocument(docName, null,null); // @C8C
return new PcmlDescriptor(pd);
} // @C5A
/**
Returns a Descriptor for the specified XPCML document.
The XPCML document resource will be loaded from the classpath.
@param docName The document resource name of the XPCML document for which the Descriptor is returned.
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml"
@param xsdStream An input stream that contains XML schema definitions that extend XPCML
@return The Descriptor for the <pcml> element of the named PCML file.
@exception PcmlException when the specified PCML document cannot be found
*/
public static Descriptor getDescriptor(String docName, InputStream xsdStream)
throws PcmlException // @C5A
{
PcmlDocument pd = null;
pd = loadPcmlDocument(docName, null, xsdStream); // @C8C
return new PcmlDescriptor(pd);
} // @C5A
/**
Returns a Descriptor for the specified PCML document.
The PCML document resource will be loaded from the classpath.
The classpath will first be searched for a serialized resource.
If a serialized resource is not found, the classpath will be
searched for a PCML source file.
@param docName The document resource name of the PCML document for which the Descriptor is returned.
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml"
@param loader The ClassLoader that will be used when loading the specified document resource.
@return The Descriptor for the <pcml> element of the named PCML file.
@exception PcmlException when the specified PCML document cannot be found
*/
public static Descriptor getDescriptor(String docName, ClassLoader loader)
throws PcmlException // @C8A
{
PcmlDocument pd = null; // @C8A
pd = loadPcmlDocument(docName, loader,null); // @C8A
return new PcmlDescriptor(pd); // @C8A
}
/**
Returns a Descriptor for the specified XPCML document.
The XPCML document resource will be loaded from the classpath.
@param docName The document resource name of the PCML document for which the Descriptor is returned.
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml"
@param loader The ClassLoader that will be used when loading the specified document resource.
@param xsdStream An input stream that contains XML schema definitions that extend XPCML.
@return The Descriptor for the <pcml> element of the named PCML file.
@exception PcmlException when the specified PCML document cannot be found
*/
public static Descriptor getDescriptor(String docName, ClassLoader loader, InputStream xsdStream)
throws PcmlException // @C8A
{
PcmlDocument pd = null; // @C8A
pd = loadPcmlDocument(docName, loader,xsdStream); // @C8A
return new PcmlDescriptor(pd); // @C8A
}
/**
Returns a Descriptor for the current PCML document.
@return The Descriptor for the <pcml> element of the current PCML file or
null if the PCML document has not be set.
*/
public Descriptor getDescriptor() // @C5A
{
if (m_pcmlDoc == null)
return null;
else
return new PcmlDescriptor(m_pcmlDoc);
} // @C5A
/**
Returns an int return value for the named service program element.
The named program element must be defined as a service program entrypoint.
The value returned is the integer return value from the most recent
call to the program. If the program has not been called, zero is returned.
@return The integer return value for the named service program element.
@param name The name of the <program> element in the PCML document.
@exception PcmlException
If an error occurs.
*/
public int getIntReturnValue(String name) throws PcmlException // @B1A
{ // @B1A
return m_pcmlDoc.getIntReturnValue(name); // @B1A
} // @B1A
/**
Returns an int value for the named element.
If the named element is String or a Number output value of a program, the value will
be converted to an int.
@return The integer value for the named element.
@param name The name of the <data> element in the PCML document.
@exception PcmlException
If an error occurs.
*/
public int getIntValue(String name)
throws PcmlException
{
return m_pcmlDoc.getIntValue(name);
}
/**
Returns an int value for the named element given indices to the data element.
If the data element is an array or is an element in a structure array, an index
must be specified for each dimension of the data.
If the named element is String or a Number output value of a program, the value will
be converted to an int.
@return The integer value for the named element.
@param name The name of the <data> element in the PCML document.
* @param indices
@exception PcmlException
If an error occurs.
*/
public int getIntValue(String name, int[] indices)
throws PcmlException
{
return m_pcmlDoc.getIntValue(name, new PcmlDimensions(indices));
}
/**
Returns the ProgramCall object that was used in the most recent invocation of {@link #callProgram(String) callProgram()}.
@return The ProgramCall object; null if callProgram() has not been called.
**/
public ProgramCall getProgramCall()
{
return ( m_pcmlDoc == null ? null : m_pcmlDoc.getProgramCall() );
}
/**
Returns a String value for the named element.
If the named element is String or a Number output value of a program, the value will
be converted to a String.
The default bidi string type is assumed ({@link com.ibm.as400.access.BidiStringType#DEFAULT BidiStringType.DEFAULT}).
@param name The name of the <data> element in the PCML document.
* @return string value of the named elements
@exception PcmlException If an error occurs.
*/
public String getStringValue(String name)
throws PcmlException
{
return m_pcmlDoc.getStringValue(name, BidiStringType.DEFAULT);
}
/**
Returns a String value for the named element.
This method is used when the string type cannot be determined until
run-time. In those cases, the PCML document cannot be used to indicate
the string type so this method is used to get the value using the
string type that is specified.
If the named element is String or a Number output value of a program, the value will
be converted to a String.
@param name The name of the <data> element in the PCML document.
@param type The bidi string type, as defined by the CDRA (Character
Data Representation Architecture).
* @return string value of the named element
@exception PcmlException
If an error occurs.
@see com.ibm.as400.access.BidiStringType
*/
public String getStringValue(String name, int type)
throws PcmlException // @C9A
{
return m_pcmlDoc.getStringValue(name, type); // @C9A
}
/**
Returns a String value for the named element given indices to the data element.
If the data element is an array or is an element in a structure array, an index
must be specified for each dimension of the data.
The default bidi string type is assumed ({@link com.ibm.as400.access.BidiStringType#DEFAULT BidiStringType.DEFAULT}).
If the named element is String or a Number output value of a program, the value will
be converted to a String.
@param name The name of the <data> element in the PCML document.
@param indices An array of indices for setting the value of an element in an array.
* @return string valud for the names element
@exception PcmlException
If an error occurs.
*/
public String getStringValue(String name, int[] indices)
throws PcmlException
{
return m_pcmlDoc.getStringValue(name, new PcmlDimensions(indices), BidiStringType.DEFAULT);
}
/**
Returns a String value for the named element given indices to the data element.
If the data element is an array or is an element in a structure array, an index
must be specified for each dimension of the data.
This method is used when the string type cannot be determined until
run-time. In those cases, the PCML document cannot be used to indicate
the string type so this method is used to get the value using the
string type that is specified.
If the named element is String or a Number output value of a program, the value will
be converted to a String.
@param name The name of the <data> element in the PCML document.
@param indices An array of indices for setting the value of an element in an array.
@param type The bidi string type, as defined by the CDRA (Character
Data Representation Architecture).
* @return string value of the named element
@exception PcmlException
If an error occurs.
@see com.ibm.as400.access.BidiStringType
*/
public String getStringValue(String name, int[] indices, int type)
throws PcmlException // @C9A
{
return m_pcmlDoc.getStringValue(name, new PcmlDimensions(indices), type); // @C9A
}
/**
Returns the list of IBM i system messages returned from running the
program. An empty list is returned if the program has not been run yet.
@param name The name of the <program> element in the PCML document.
@return The array of messages returned by the system for the program.
@exception PcmlException
If an error occurs.
*/
public AS400Message[] getMessageList(String name)
throws PcmlException
{
return m_pcmlDoc.getMessageList(name);
}
/**
Returns the number of bytes reserved for output for the named element.
@return The number of bytes reserved for output for the named element.
@param name The name of the <data> or <struct> element in the PCML document.
@exception PcmlException
If an error occurs.
*/
public int getOutputsize(String name)
throws PcmlException
{
return m_pcmlDoc.getOutputsize(name);
}
/**
Returns the number of bytes reserved for output for the named element and indices.
@return The number of bytes reserved for output for the named element.
@param name The name of the <data> or <struct> element in the PCML document.
@param indices An array of indices for accessing the output size of an element in an array.
@exception PcmlException
If an error occurs.
*/
public int getOutputsize(String name, int[] indices)
throws PcmlException
{
return m_pcmlDoc.getOutputsize(name, new PcmlDimensions(indices));
}
/**
Returns the Java object value for the named element.
If the named element is an output value of a program, the value will
be converted from IBM i system data to a Java Object.
The type of object returned depends on the description in the PCML document.
PCML Description Object Returned type=charStringtype=bytebyte[]type=int
length=2
precision=15Shorttype=int
length=2
precision=16Integertype=int
length=4
precision=31Integertype=int
length=4
precision=32Longtype=int
length=8
precision=63Longtype=int
length=8
precision=64BigIntegertype=packedBigDecimaltype=zonedBigDecimaltype=float
length=4Floattype=float
length=8Doubletype=datejava.sql.Datetype=timejava.sql.Timetype=timestampjava.sql.Timestamp
@return The Java object value for the named <data> element in the PCML document.
@param name The name of the <data> element in the PCML document.
@exception PcmlException
If an error occurs.
*/
public Object getValue(String name)
throws PcmlException
{
if (Trace.isTraceOn()) Trace.log(Trace.PCML, "Entered method ProgramCallDocument.getValue("+name+")");
Object val = m_pcmlDoc.getValue(name);
if (Trace.isTraceOn()) Trace.log(Trace.PCML, "Exiting method ProgramCallDocument.getValue("+name+")");
return val;
}
/**
Returns the Java object value for the named element given indices to the data element.
If the data element is an array or is an element in a structure array, an index
must be specified for each dimension of the data.
If the named element is an output value of a program, the value will
be converted from IBM i system data to a Java Object.
The type of object returned depends on the description in the PCML document.
PCML Description Object Returned type=charStringtype=bytebyte[]type=int
length=2
precision=15Shorttype=int
length=2
precision=16Integertype=int
length=4
precision=31Integertype=int
length=4
precision=32Longtype=int
length=8
precision=63Longtype=int
length=8
precision=64BigIntegertype=packedBigDecimaltype=zonedBigDecimaltype=float
length=4Floattype=float
length=8Doubletype=datejava.sql.Datetype=timejava.sql.Timetype=timestampjava.sql.Timestamp
@return The Java object value for the named <data> element in the PCML document.
@param name The name of the <data> element in the PCML document.
@param indices An array of indices for accessing the value of an element in an array.
@exception PcmlException
If an error occurs.
*/
public Object getValue(String name, int[] indices)
throws PcmlException
{
if (Trace.isTraceOn()) Trace.log(Trace.PCML, "Entered method ProgramCallDocument.getValue("+name+", indices)");
Object val = m_pcmlDoc.getValue(name, new PcmlDimensions(indices));
if (Trace.isTraceOn()) Trace.log(Trace.PCML, "Exiting method ProgramCallDocument.getValue("+name+", indices)");
return val;
}
/**
Gets the system on which programs are to be called.
@return The current system for this ProgramCallDocument.
@see #setSystem
**/
public AS400 getSystem() // @C4A
{ // @C4A
return m_as400; // @C4A
} // @C4A
/**
Serializes the ProgramCallDocument. Note that XPCML documents
cannot be serialized.
The filename of the serialized file will be of the form
docName.pcml.ser
where docName.pcml.ser (lowercase) is the name of the document used to
construct this object.
@exception PcmlException If an error occurs.
@deprecated Use {@link #serialize(File) serialize(File)} instead.
*/
public void serialize()
throws PcmlException
{
if (m_pcmlDoc == null) {
throw new PcmlException(DAMRI.DOCUMENT_NOT_SET);
}
try {
savePcmlDocument(m_pcmlDoc);
}
catch (IOException e) {
if (Trace.isTraceErrorOn())
e.printStackTrace(Trace.getPrintWriter());
throw new PcmlException(e);
}
}
/**
Serializes the ProgramCallDocument to a stream.
@param outputStream The output stream to which to serialize the object.
@exception IOException If an error occurs while writing to the stream.
@exception PcmlException If an error occurs while processing PCML.
**/
public void serialize(OutputStream outputStream)
throws IOException, PcmlException
{
if (outputStream == null) {
throw new NullPointerException("outputStream");
}
if (m_pcmlDoc == null) {
throw new PcmlException(DAMRI.DOCUMENT_NOT_SET);
}
savePcmlDocument(m_pcmlDoc, outputStream);
}
/**
Serializes the ProgramCallDocument to a file.
@param file The file to which to serialize the object.
@exception IOException If an error occurs while writing to the file.
@exception XmlException If an error occurs while processing RFML.
**/
public void serialize(File file)
throws IOException, XmlException
{
FileOutputStream fos = null;
try
{
fos = new FileOutputStream(file);
serialize(fos);
}
finally
{
if (fos != null) fos.close();
}
}
/**
Sets the Java object value for the named element using a int input.
The named element must be able to be set using a Integer object.
@param name The name of the <data> element in the PCML document.
@param value The int value for the named element.
@exception PcmlException
If an error occurs.
*/
public void setIntValue(String name, int value)
throws PcmlException
{
setValue(name, new Integer(value));
}
/**
Sets the Java object value for the named element using an int input value
given indices to the data element.
The named element must be able to be set using a Integer object.
@param name The name of the <data> element in the PCML document.
@param indices An array of indices for setting the value of an element in an array.
@param value The int value for the named element.
@exception PcmlException
If an error occurs.
*/
public void setIntValue(String name, int[] indices, int value)
throws PcmlException
{
setValue(name, indices, new Integer(value));
}
/**
Sets the Java object value for the named element using a String input.
The default bidi string type is assumed ({@link com.ibm.as400.access.BidiStringType#DEFAULT BidiStringType.DEFAULT}).
@param name The name of the <data> element in the PCML document.
@param value The string value for the named element.
@exception PcmlException If an error occurs.
*/
public void setStringValue(String name, String value)
throws PcmlException
{
setStringValue(name, value, BidiStringType.DEFAULT);
}
/**
Sets the Java object value for the named element using a String input.
This method is used when the string type cannot be determined until
run-time. In those cases, the PCML document cannot be used to indicate
the string type so this method is used to set the value and the
string type of the input value.
@param name The name of the <data> element in the PCML document.
@param value The string value for the named element.
@param type The bidi string type, as defined by the CDRA (Character
Data Representation Architecture).
@exception PcmlException
If an error occurs.
@see com.ibm.as400.access.BidiStringType
*/
public void setStringValue(String name, String value, int type)
throws PcmlException // @C9A
{
m_pcmlDoc.setStringValue(name, value, type); // @C9A
}
/**
Sets the Java object value for the named element using a String input value
given indices to the data element.
This method is used when the string type cannot be determined until
run-time. In those cases, the PCML document cannot be used to indicate
the string type so this method is used to set the value and the
string type of the input value.
@param name The name of the <data> element in the PCML document.
@param indices An array of indices for setting the value of an element in an array.
@param value The string value for the named element.
@param type The bidi string type, as defined by the CDRA (Character
Data Representation Architecture).
@exception PcmlException
If an error occurs.
@see com.ibm.as400.access.BidiStringType
*/
public void setStringValue(String name, int[] indices, String value, int type)
throws PcmlException // @C9A
{
m_pcmlDoc.setStringValue(name, value, new PcmlDimensions(indices), type); // @C9A
}
/**
Sets the PCML or XPCML document resource.
The PCML or XPCML document resource will be loaded from the classpath.
The classpath will first be searched for a serialized resource.
If a serialized resource is not found, the classpath will be
searched for a PCML or XPCML source file.
@param docName The document resource name of the PCML document for the programs to be called.
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml"
@exception PcmlException when the specified PCML document cannot be found
**/
public void setDocument(String docName)
throws PcmlException // @C1A
{ // @C1A
if (m_pcmlDoc != null) // @C1A
throw new PcmlException(DAMRI.DOCUMENT_ALREADY_SET ); // @C1A
if (docName == null) // @C1A
throw new NullPointerException("docName"); // @C1A
m_pcmlDoc = loadPcmlDocument(docName, null,null); // @C1A @C8C
if (m_as400 != null) m_pcmlDoc.setAs400(m_as400); // @C1A
} // @C1A
/**
Sets the XPCML document resource.
The XPCML document resource will be loaded from the classpath.
@param docName The document resource name of the PCML document for the programs to be called.
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml"
@param xsdStream An input stream that contains XML schema definitions that extend XPCML
@exception PcmlException when the specified PCML document cannot be found
**/
public void setDocument(String docName, InputStream xsdStream)
throws PcmlException // @C1A
{ // @C1A
if (m_pcmlDoc != null) // @C1A
throw new PcmlException(DAMRI.DOCUMENT_ALREADY_SET ); // @C1A
if (docName == null) // @C1A
throw new NullPointerException("docName"); // @C1A
m_pcmlDoc = loadPcmlDocument(docName, null,xsdStream); // @C1A @C8C
if (m_as400 != null) m_pcmlDoc.setAs400(m_as400); // @C1A
} // @C1A
/**
Sets the PCML or XPCML document resource.
The PCML or XPCML document resource will be loaded from the classpath.
The classpath will first be searched for a serialized resource.
If a serialized resource is not found, the classpath will be
searched for a PCML or XPCML source file.
@param docName The document resource name of the PCML document for the programs to be called.
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml"
@param loader The ClassLoader that will be used when loading the specified document resource.
@exception PcmlException when the specified PCML document cannot be found
**/
public void setDocument(String docName, ClassLoader loader) // @C8A
throws PcmlException // @C8A
{ // @C8A
if (m_pcmlDoc != null) // @C8A
throw new PcmlException(DAMRI.DOCUMENT_ALREADY_SET ); // @C8A
if (docName == null) // @C8A
throw new NullPointerException("docName"); // @C8A
m_pcmlDoc = loadPcmlDocument(docName, loader,null); // @C8A
if (m_as400 != null) m_pcmlDoc.setAs400(m_as400); // @C8A
} // @C8A
/**
Sets the PCML or XPCML document resource.
The document resource will be loaded from the classpath.
@param docName The document resource name of the PCML or XPCML document for the programs to be called.
The resource name can be a package qualified name. For example, "com.myCompany.myPackage.myPcml"
@param loader The ClassLoader that will be used when loading the specified document resource.
@param xsdStream An input stream that contains XML schema definitions that extend XPCML
@exception PcmlException when the specified PCML document cannot be found
**/
public void setDocument(String docName, ClassLoader loader,InputStream xsdStream) // @C8A
throws PcmlException // @C8A
{ // @C8A
if (m_pcmlDoc != null) // @C8A
throw new PcmlException(DAMRI.DOCUMENT_ALREADY_SET ); // @C8A
if (docName == null) // @C8A
throw new NullPointerException("docName"); // @C8A
m_pcmlDoc = loadPcmlDocument(docName, loader, xsdStream); // @C8A
m_pcmlDoc.setAs400(m_as400); // @C8A
} // @C8A
/**
Sets the system on which to call programs.
@param system The system on which to call programs.
**/
public void setSystem(AS400 system) // @C1A
{ // @C1A
if (system == null) // @C1A
throw new NullPointerException("system"); // @C1A
m_as400 = system; // @C1A
m_pcmlDoc.setAs400(m_as400); // @C1A
} // @C1A
/**
Sets the Java object value for the named element.
If the input value provided is not an instance of the
correct Java class for the defined data type, it will be converted
to the correct Java class. For example, an element defined as "type=int length=2 precision=15",
will be converted to a Java Short object. In this case the value specified must be an instance of Number or String.
If the named element is an input value to a program, the value will
be converted to IBM i system data when {@link #callProgram(String) callProgram()} is called.
@param name The name of the <data> element in the PCML document.
@param value The java object value for the named element. The type of Object passed must be
the correct type for the element definition or a String that can be converted to the correct type.
@exception PcmlException
If an error occurs.
*/
public void setValue(String name, Object value)
throws PcmlException
{
m_pcmlDoc.setValue(name, value);
}
/**
Sets the Java object value for the named element
given indices to the data element.
If the data element is an array or is an element in a structure array, an index
must be specified for each dimension of the data.
If the input value provided is not an instance of the
correct Java class for the defined data type, it will be converted
to the correct Java class. For example, an element defined as "type=int length=2 precision=15",
will be converted to a Java Short object. In this case the value specified must be an instance of Number or String.
If the named element is an input value to a program, the value will
be converted to IBM i system data when {@link #callProgram(String) callProgram()} is called.
@param name The name of the <data> element in the PCML document.
@param indices An array of indices for setting the value of an element in an array.
@param value The java object value for the named element. The type of Object passed must be
the correct type for the element definition or a String that can be converted to the correct type.
@exception PcmlException
If an error occurs.
*/
public void setValue(String name, int[] indices, Object value)
throws PcmlException
{
m_pcmlDoc.setValue(name, value, new PcmlDimensions(indices));
}
/**
Allows for dynamically specifying the program path of the program to be called.
@param program The name of the <program> element in the PCML document.
@param path A String containing the path to the program object to be run on the system.
@exception PcmlException
If an error occurs.
@see #setDocument(String)
@see #ProgramCallDocument(AS400,String,InputStream,ClassLoader,InputStream,int)
*/
public void setPath(String program, String path) // @D1A
throws PcmlException // @D1A
{
m_pcmlDoc.setPath(program, path); // @D1A
}
/**
Allows the overriding of the threadsafe attribute of a program element.
@param program The name of the <program> element in the PCML document.
@param threadsafe A boolean indicating whether the named program element should be considered
thread safe (true) or not (false).
@exception PcmlException
If an error occurs.
*/
public void setThreadsafeOverride(String program, boolean threadsafe)
throws PcmlException
{
m_pcmlDoc.setThreadsafeOverride(program, threadsafe); // @C6A
}
/**
Gets the value of the override of the threadsafe attribute of a program element.
@param program The name of the <program> element in the PCML document.
* @return true if the program is threadsafe
@exception PcmlException
If an error occurs.
*/
public boolean getThreadsafeOverride(String program)
throws PcmlException
{
return m_pcmlDoc.getThreadsafeOverride(program); // @C6A
}
/**
Saves a PcmlDocument as a serialized resource.
**/
private static void savePcmlDocument(PcmlDocument pd)
throws PcmlException, IOException
{
String outFileName = pd.getDocName() + SystemResourceFinder.m_pcmlSerializedExtension;
BufferedOutputStream fos = null;
try
{
fos = new BufferedOutputStream(new FileOutputStream(outFileName));
savePcmlDocument(pd, fos);
}
finally
{
if (fos != null) fos.close();
}
}
/**
Saves a PcmlDocument as a serialized resource.
**/
private static void savePcmlDocument(PcmlDocument pd, OutputStream outStream)
throws PcmlException, IOException
{
pd.setSerializingWithData(false);
ObjectOutputStream out = null;
try
{
out = new ObjectOutputStream(outStream);
out.writeObject(pd);
String outFileName = pd.getDocName() + SystemResourceFinder.m_pcmlSerializedExtension;
Trace.log(Trace.PCML, SystemResourceFinder.format(DAMRI.PCML_SERIALIZED, new Object[] {outFileName} )); // @D2C
}
finally
{
if (out != null) out.close();
}
}
/**
Loads a serialized PcmlDocument or constructs the document from
a PCML source file.
**/
private static PcmlDocument loadPcmlDocument(String docName, ClassLoader loader, InputStream xsdStream) // @C8C
throws PcmlException
{
PcmlDocument pd = null;
pd = loadSerializedPcmlDocument(docName, loader); // @C8C
// If a PcmlDocument was successfully loaded from a serialized file
// return the document loaded.
if (pd != null)
return pd;
pd = loadZippedSerializedPcmlDocument(docName, loader); // @C7A @C8C
// If a PcmlDocument was successfully loaded from a zipped serialized file
// return the document loaded.
if (pd != null) // @C7A
return pd; // @C7A
pd = loadSourcePcmlDocument(docName, loader, xsdStream); // @C8C
return pd;
}
private static PcmlDocument loadSerializedPcmlDocumentFromStream(InputStream docStream)
throws PcmlException
{
PcmlDocument pd = null;
ObjectInputStream in = null;
try
{
// Try to open the serialized PCML document
in = new ObjectInputStream(docStream);
pd = (PcmlDocument)in.readObject();
}
catch (Exception e)
{
if (Trace.isTraceErrorOn())
e.printStackTrace(Trace.getPrintWriter());
throw new PcmlException(e);
}
finally
{
if (in != null) try { in.close(); } catch (Exception e) {}
}
return pd;
}
private static PcmlDocument loadSourcePcmlDocumentFromStream(String docName, InputStream docStream, ClassLoader loader, InputStream xsdStream, boolean isXPCML) throws PcmlException
{
PcmlDocument pd = null;
// Construct the PCML document from a source file
try
{
PcmlSAXParser psp = new PcmlSAXParser(docName, docStream, xsdStream, isXPCML, exceptionIfParseError_);
pd = psp.getPcmlDocument();
}
catch (ParseException pe)
{
if (Trace.isTraceErrorOn())
pe.printStackTrace(Trace.getPrintWriter());
pe.reportErrors();
throw new PcmlException(pe);
}
catch (PcmlSpecificationException pse)
{
if (Trace.isTraceErrorOn())
pse.printStackTrace(Trace.getPrintWriter());
pse.reportErrors();
throw new PcmlException(pse);
}
catch (RuntimeException e)
{
if (Trace.isTraceErrorOn())
e.printStackTrace(Trace.getPrintWriter());
Throwable cause = e.getCause();
if (cause instanceof PcmlSpecificationException)
{
PcmlSpecificationException pse = (PcmlSpecificationException)cause;
pse.reportErrors();
throw new PcmlException(pse);
}
else
{
if (Trace.isTraceErrorOn()) //@E0A
e.printStackTrace(Trace.getPrintWriter()); //@E0A
throw new PcmlException(e);
}
}
catch (Exception e)
{
if (Trace.isTraceErrorOn())
e.printStackTrace(Trace.getPrintWriter());
throw new PcmlException(e);
}
return pd;
}
/**
Loads a serialized PcmlDocument from a serialized file.
**/
private static PcmlDocument loadSerializedPcmlDocument(String docName, ClassLoader loader) // @C8C
throws PcmlException
{
PcmlDocument pd = null;
InputStream is = null;
ObjectInputStream in = null;
// First try to find a serialized PCML document
try
{
// Try to open the serialized PCML document
is = SystemResourceFinder.getSerializedPCMLDocument(docName, loader); // @C8C
in = new ObjectInputStream(is);
pd = (PcmlDocument)in.readObject();
}
catch (MissingResourceException e)
{
// Ignore exception and try looking for PCML source (below)
}
catch (StreamCorruptedException e)
{
// Ignore exception and try looking for zipped serialized PCML (below)
}
catch (IOException e)
{
if (Trace.isTraceErrorOn()) // @C4A
e.printStackTrace(Trace.getPrintWriter()); // @C4C
throw new PcmlException(e);
}
catch (ClassNotFoundException e)
{
if (Trace.isTraceErrorOn()) // @C4A
e.printStackTrace(Trace.getPrintWriter()); // @C4C
throw new PcmlException(e);
}
finally
{
if (in != null) try { in.close(); } catch (Exception e) {
if (Trace.isTraceErrorOn())
e.printStackTrace(Trace.getPrintWriter());
}
if (is != null) try { is.close(); } catch (Exception e) {
if (Trace.isTraceErrorOn())
e.printStackTrace(Trace.getPrintWriter());
}
}
return pd;
}
/**
Loads a serialized PcmlDocument from a serialized file.
**/
private static PcmlDocument loadZippedSerializedPcmlDocument(String docName, ClassLoader loader) // @C8C
throws PcmlException
{
PcmlDocument pd = null;
InputStream is = null;
GZIPInputStream gzis = null;
ObjectInputStream in = null;
// First try to find a serialized PCML document
try
{
// Try to open the serialized PCML document
is = SystemResourceFinder.getSerializedPCMLDocument(docName, loader); // @C8C
gzis = new GZIPInputStream(is);
in = new ObjectInputStream(gzis);
pd = (PcmlDocument)in.readObject();
}
catch (MissingResourceException e)
{
// Ignore exception and try looking for PCML source (below)
}
catch (IOException e)
{
if (Trace.isTraceErrorOn()) // @C4A
e.printStackTrace(Trace.getPrintWriter()); // @C4C
throw new PcmlException(e);
}
catch (ClassNotFoundException e)
{
if (Trace.isTraceErrorOn()) // @C4A
e.printStackTrace(Trace.getPrintWriter()); // @C4C
throw new PcmlException(e);
}
finally
{
if (in != null) try { in.close(); } catch (Exception e) {
if (Trace.isTraceErrorOn())
e.printStackTrace(Trace.getPrintWriter());
}
if (gzis != null) try { gzis.close(); } catch (Exception e) {
if (Trace.isTraceErrorOn())
e.printStackTrace(Trace.getPrintWriter());
}
if (is != null) try { is.close(); } catch (Exception e) {
if (Trace.isTraceErrorOn())
e.printStackTrace(Trace.getPrintWriter());
}
}
return pd;
}
/**
Loads a PcmlDocument from a PCML source file.
**/
private static PcmlDocument loadSourcePcmlDocument(String docName, ClassLoader loader, InputStream xsdStream) // @C8C
throws PcmlException
{
PcmlDocument pd = null;
// Construct the PCML document from a source file
try
{
InputStream docStream = SystemResourceFinder.getPCMLDocument(docName, loader);
boolean isXPCML = SystemResourceFinder.isXPCML(docName,loader);
PcmlSAXParser psp = new PcmlSAXParser(docName, docStream, xsdStream, isXPCML, exceptionIfParseError_); // @C2A @C8C
pd = psp.getPcmlDocument(); // @C2A
}
catch (ParseException pe)
{
pe.reportErrors();
throw new PcmlException(pe);
}
catch (PcmlSpecificationException pse)
{
pse.reportErrors();
throw new PcmlException(pse);
}
catch (RuntimeException e)
{
Throwable cause = e.getCause();
if (cause instanceof PcmlSpecificationException)
{
PcmlSpecificationException pse = (PcmlSpecificationException)cause;
pse.reportErrors();
throw new PcmlException(pse);
}
else
{
if (Trace.isTraceErrorOn()) //@E0A
e.printStackTrace(Trace.getPrintWriter()); //@E0A
throw new PcmlException(e);
}
}
catch (Exception e) //@E0A
{
if (Trace.isTraceErrorOn()) //@E0A
e.printStackTrace(Trace.getPrintWriter()); //@E0A
throw new PcmlException(e);
}
return pd;
}
// @E1A -- ALL NEW XPCML methods....
/**
Generates XPCML representing the data associated with the passed-in program name.
Note: XPCML cannot be generated from a serialized PCML file.
XPCML is XML based on the XML schema defined in xpcml.xsd. XPCML is similar
to PCML but allows for better validation of parameters and allows parameter
data to be input and output within an XML document. PCML is data-less in
that only parameter formats are input via PCML. In PCML, data values are set using
the setValue methods of the ProgramCallDocument class, and data values are
gotten using the getValue methods of ProgramCallDocument. In XPCML, data values
can be specified directly within the XPCML source document, and data values can be output
as XML using the generateXPCML method.
Throws an XmlException if this object contains no data.
@param pgmName The program to generate XPCML for
@param outputStream The output stream to which to write the text.
@exception IOException If an error occurs while writing the data.
@exception XmlException If an error occurs while processing XPCML.
**/
public void generateXPCML(String pgmName, OutputStream outputStream)
throws IOException, XmlException
{
if (outputStream == null) {
throw new NullPointerException("outputStream");
}
if (m_pcmlDoc == null) {
throw new XmlException(DAMRI.DOCUMENT_NOT_SET );
}
m_pcmlDoc.generateXPCML(pgmName, outputStream);
}
// @E2C -- Added more info on XPCML. Changed all RFML references to XPCML.
/**
Generates XPCML representing the data contained in the entire PCML node tree.
Note: XPCML cannot be generated from a serialized PCML file.
XPCML is XML based on the XML schema defined in xpcml.xsd. XPCML is similar
to PCML but allows for better validation of parameters and allows parameter
data to be input and output within an XML document. PCML is data-less in
that only parameter formats are input via PCML. In PCML, data values are set using
the setValue methods of the ProgramCallDocument class and data values are
gotten using the getValue methods of ProgramCallDocument. In XPCML, data values
can be specified directly within the XPCML document, and data values can be output
as XML using the generateXPCML method.
Throws an XmlException if this object contains no data.
@param outputStream The output stream to which to write the text.
@exception IOException If an error occurs while writing the data.
@exception XmlException If an error occurs while processing XPCML.
**/
public void generateXPCML(OutputStream outputStream)
throws IOException, XmlException
{
if (outputStream == null) {
throw new NullPointerException("outputStream");
}
if (m_pcmlDoc == null) {
throw new XmlException(DAMRI.DOCUMENT_NOT_SET );
}
m_pcmlDoc.generateXPCML(null, outputStream);
}
/**
Generates XPCML representing the data contained in the entire PCML node tree.
Note: XPCML cannot be generated from a serialized PCML file.
XPCML is XML based on the XML schema defined in xpcml.xsd. XPCML is similar
to PCML but allows for better validation of parameters and allows parameter
data to be input and output within an XML document. PCML is data-less in
that only parameter formats are input via PCML. In PCML, data values are set using
the setValue methods of the ProgramCallDocument class and data values are
gotten using the getValue methods of ProgramCallDocument. In XPCML, data values
can be specified directly within the XPCML document, and data values can be output
as XML using the generateXPCML method.
Throws an XmlException if this object contains no data.
@param fileName The pathname of the file to which to write the text.
@exception IOException If an error occurs while writing the data.
@exception XmlException If an error occurs while processing XPCML.
**/
public void generateXPCML(String fileName)
throws IOException, XmlException
{
if (fileName == null) {
throw new NullPointerException("fileName");
}
FileOutputStream fos = null;
try
{
fos = new FileOutputStream(fileName);
generateXPCML(null, fos);
}
finally {
if (fos != null) fos.close();
}
}
/**
Generates XPCML representing the data contained for the passed in program name.
Note: XPCML cannot be generated from a serialized PCML file.
XPCML is XML based on the XML schema defined in xpcml.xsd. XPCML is similar
to PCML but allows for better validation of parameters and allows parameter
data to be input and output within an XML document. PCML is data-less in
that only parameter formats are input via PCML. In PCML, data values are set using
the setValue methods of the ProgramCallDocument class and data values are
gotten using the getValue methods of ProgramCallDocument. In XPCML, data values
can be specified directly within the XPCML document, and data values can be output
as XML using the generateXPCML method.
Throws an XmlException if this object contains no data.
@param pgmName The program name to generate XPCML for.
@param fileName The pathname of the file to which to write the text.
@exception IOException If an error occurs while writing the data.
@exception XmlException If an error occurs while processing XPCML.
**/
public void generateXPCML(String pgmName,String fileName)
throws IOException, XmlException
{
if (fileName == null) {
throw new NullPointerException("fileName");
}
if (pgmName == null) {
throw new NullPointerException("pgmName");
}
FileOutputStream fos = null;
try
{
fos = new FileOutputStream(fileName);
generateXPCML(pgmName, fos);
}
finally {
if (fos != null) fos.close();
}
}
// ******************************
// @E0A -- New method *
// ******************************
/**
Sets the XSD name that will appear in the generated <xpcml> tag from the generateXPCML() methods.
If name is not set then "xpcml.xsd" will appear in <xpcml> tag. This allows the user
to override the default and put in the name of their own xsd that was
used in condensing the XPCML output.
@param xsdName The XSD name to appear in the <xpcml> tag when XPCML is output using the
generateXPCML method.
**/
public void setXsdName(String xsdName)
{
m_pcmlDoc.setXsdName(xsdName);
}
// ******************************
// @E0A -- New method *
// ******************************
/**
Returns the value of the XSD name to be used on the <xpcml> tag when
generating XPCML.
@return The String "xsdName" value for this program object.
**/
public String getXsdName()
{
return m_pcmlDoc.getXsdName();
}
/**
Transforms a PCML stream to its equivalent XPCML stream.
Throws an XmlException if this object contains no data.
@param pcmlStream The PCML input stream.
@param xpcmlStream The output XPCML stream.
@exception IOException If an error occurs while writing the data.
@exception PcmlException If an error occurs while processing XPCML.
* @throws TransformerException
* @throws SAXException
**/
public static void transformPCMLToXPCML(InputStream pcmlStream, OutputStream xpcmlStream)
throws IOException, PcmlException, TransformerException, SAXException
{
if (pcmlStream == null) {
throw new NullPointerException("pcmlStream");
}
if (xpcmlStream == null) {
throw new NullPointerException("xpcmlStream");
}
// Transform the PCML document to its equivalent XPCML document
XPCMLHelper.doTransform("pcml_xpcml.xsl",pcmlStream, xpcmlStream); //@CRS
}
/**
Transforms a fully specified XPCML stream to a more condensed XPCML stream
and an XSD stream representing the new type definitions created while condensing.
Throws an XmlException if this object contains no data.
@param fullStream The full XPCML input stream.
@param xsdStream The output xsd stream.
@param condensedStream The output condensed XPCML stream.
@param xsdStreamName The name of the xsd stream ("name.xsd") that will be created
@exception IOException If an error occurs while writing the data.
@exception PcmlException If an error occurs while processing XPCML.
* @throws TransformerException
* @throws SAXException
**/
public static void condenseXPCML(InputStream fullStream, OutputStream xsdStream, OutputStream condensedStream, String xsdStreamName)
throws IOException, PcmlException, TransformerException, SAXException
{
String xpcmlName="";
if (fullStream == null) {
throw new NullPointerException("fullStream");
}
if (xsdStream == null) {
throw new NullPointerException("xsdStream");
}
if (condensedStream == null) {
throw new NullPointerException("condensedStream");
}
if (xsdStreamName == null) {
throw new NullPointerException("xsdStreamName");
}
// Copy input stream fullStream into twoOutputStream
ByteArrayOutputStream outStream1 = new ByteArrayOutputStream();
byte[] bytesIn = new byte[1000];
int bytesRead = 0;
bytesRead = fullStream.read(bytesIn);
while (bytesRead != -1)
{
outStream1.write(bytesIn,0,bytesRead);
bytesRead = fullStream.read(bytesIn);
}
outStream1.flush();
outStream1.close();
// Cache the line count of the header
ByteArrayInputStream inStreamFull = new ByteArrayInputStream(outStream1.toByteArray());
LineNumberReader lnr = new LineNumberReader(new InputStreamReader(inStreamFull));
try
{
String line = lnr.readLine();
boolean found=false;
while (line != null && !found)
{
// Look for xpcml tag
if (line.indexOf("xsi:noNamespaceSchemaLocation=") != -1)
{
found = true;
int index1 = line.indexOf("xsi:noNamespaceSchemaLocation=");
int index2=0;
index2 = line.indexOf("'", index1);
int index3=0;
if (index2 == -1)
{
index2 = line.indexOf("\"",index1);
if (index2 != -1)
index3 = line.indexOf("\"", index2+1);
}
else
{
index3 = line.indexOf("'",index2+1);
}
xpcmlName = line.substring(index2+1,index3);
continue;
}
if (line.indexOf("xsi:noNamespaceSchemaLocation =") != -1)
{
found = true;
int index1 = line.indexOf("xsi:noNamespaceSchemaLocation =");
int index2=0;
index2 = line.indexOf("'", index1);
int index3=0;
if (index2 == -1)
{
index2 = line.indexOf("\"",index1);
if (index2 != -1)
index3 = line.indexOf("\"", index2+1);
}
else
{
index3 = line.indexOf("'",index2+1);
}
xpcmlName = line.substring(index2+1,index3);
continue;
}
line = lnr.readLine();
}
}
catch (IOException e)
{
Trace.log(Trace.PCML, "Error when reading input stream in condenseXPCML");
if (Trace.isTraceErrorOn())
e.printStackTrace(Trace.getPrintWriter());
throw new PcmlException(e);
}
if (xpcmlName == "")
xpcmlName="xpcml.xsd";
// Write contents of ByteArrayOutputStream to ByteArrayInputStream
ByteArrayInputStream inStream1 = new ByteArrayInputStream(outStream1.toByteArray()); // no need to close byte-array stream
ByteArrayInputStream inStream2 = new ByteArrayInputStream(outStream1.toByteArray()); // no need to close byte-array stream
// Create new XSD type definitions based on full XPCML stream
XPCMLHelper.doCondenseTransform("xpcml_xsd.xsl",inStream1, xsdStream, xpcmlName); //@CRS
// Create condensed XPCML using XSD and full XPCML stream
XPCMLHelper.doCondenseTransform("xpcml_basic.xsl",inStream2, condensedStream, xsdStreamName); //@CRS
}
// Traces a warning message about a null-valued parameter.
private static final void warnNull(String parmName)
{
if (Trace.isTraceOn()) Trace.log(Trace.WARNING, "Null value specified for '" + parmName + "' parameter on ProgramCallDocument constructor.");
}
//@Y6A Start
public void setTimeOut(int timeOut) {
m_timeOut = timeOut;
}
public int getTimeout() {
return m_timeOut;
}
//@Y6A End
}