Interstage Shunsaku Data Manager Application Development Guide - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX -

M.2.2 executeAdd

Function

This method adds XML documents stored in the specified text file to a Shunsaku

Syntax

public void executeAdd(
    String   xmlDatafileName      /* (1) Path to the text file       */
) throws ShunException;

Return Value

None

Parameters

(1) Path to the text file

Specifies the full pathname of the text file containing XML document that is to be added.The character encoding of the XML document to be added must be the same as that of the data stored in Shunsaku. Note, however, that the character encoding specified in the XML root tag is disabled.

To add multiple items of XML documents, it is recommended that the data be joined together into a single text file and specified as an argument.

Exceptions

ShunException

ShunException is output when an error occurs while XML documents are being added.

Refer to M.4 Error Codes Output for details on error codes.

Notes

• Because this method is invoked synchronously, control does not return to the invoking source until all data has been added.
• The data added by the executeAdd method cannot be searched until the method completes normally.
• Do not delete the text file specified as an argument until this method completes.