XMP公用程式服務Java API快速入門(SOAP) xmp-utilities-service-java-apiquick-start-soap
下列「快速啟動」適用於「XMP公用程式」服務。
快速入門(SOAP模式)：使用Java API匯出XMP中繼資料
快速入門(SOAP模式)：使用Java API匯入XMP中繼資料
AEM Forms作業可使用AEM Forms強型別API執行，且連線模式應設定為SOAP。
NOTE
如果使用UNIX等其他作業系統，請將Windows專用的路徑取代為適用作業系統支援的路徑，則「使用AEM表單進行程式設計」中的快速入門是以Forms伺服器為基礎。 同樣地，如果您使用其他J2EE應用程式伺服器，請確定您指定有效的連線屬性。 請參閱設定連線內容。
快速入門(SOAP模式)：使用Java API匯出XMP中繼資料 quick-start-soap-mode-exporting-xmp-metadata-using-the-java-api
下列程式碼範例會擷取、檢查及儲存XMP中繼資料。 (請參閱從PDF檔案匯出中繼資料。)
/*
* This Java Quick Start uses the following JAR files
* 1. adobe-pdfutility-client.jar
* 2. adobe-livecycle-client.jar
* 3. adobe-usermanager-client.jar
* 4. activation.jar (required for SOAP mode)
* 5. axis.jar (required for SOAP mode)
* 6. commons-codec-1.3.jar (required for SOAP mode)
* 7. commons-collections-3.2.jar (required for SOAP mode)
* 8. commons-discovery.jar (required for SOAP mode)
* 9. commons-logging.jar (required for SOAP mode)
* 10. dom3-xml-apis-2.5.0.jar (required for SOAP mode)
* 11. jaxen-1.1-beta-9.jar (required for SOAP mode)
* 12. jaxrpc.jar (required for SOAP mode)
* 13. log4j.jar (required for SOAP mode)
* 14. mail.jar (required for SOAP mode)
* 15. saaj.jar (required for SOAP mode)
* 16. wsdl4j.jar (required for SOAP mode)
* 17. xalan.jar (required for SOAP mode)
* 18. xbean.jar (required for SOAP mode)
* 19. xercesImpl.jar (required for SOAP mode)
*
* The JBoss files must be kept in the jboss\client folder. You can copy the client folder to
* your local development environment and then include the 3 JBoss JAR files in your class path
*
* These JAR files are in the following path:
* <install directory>/sdk/client-libs/common
*
*
* <install directory>/jboss/bin/client
*
* If you want to invoke a remote Forms Server instance and there is a
* firewall between the client application and the server, then it is
* recommended that you use the SOAP mode. When using the SOAP mode,
* you have to include additional JAR files in the following
* path
* <install directory>/sdk/client-libs/thirdparty
*
* For information about the SOAP
* mode and the additional JAR files that need to be included,
* see "Setting connection properties" in Programming
* with AEM Forms
*
* For complete details about the location of the AEM Forms JAR files,
* see "Including AEM Forms Java library files" in Programming
* with AEM Forms
*/
import com.adobe.livecycle.xmputility.*;
import com.adobe.livecycle.xmputility.client.*;
import java.util.*;
import java.io.*;
import com.adobe.idp.Document;
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory;
import com.adobe.idp.dsc.clientsdk.ServiceClientFactoryProperties;
public class ExportMetadata
{
public static void main(String[] args)
{
try
{
//Set connection properties required to invoke AEM Forms
Properties connectionProps = new Properties();
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT, "https://'[server]:[port]'");
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL);
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");
//Create a ServiceClientFactory instance
ServiceClientFactory factory = ServiceClientFactory.createInstance(connectionProps);
// Create a XMP Utility client
XMPUtilityServiceClient xmpUt = new XMPUtilityServiceClient(factory);
// Specify a PDF document whose metadata is to be exported
FileInputStream fileInputStream = new FileInputStream("C:\\Adobe\Loan.pdf");
Document inDoc = new Document(fileInputStream);
// Export the XMP metadata object
XMPUtilityMetadata myXmp = xmpUt.exportMetadata(inDoc);
// Inspect the XMP metadata object (retrieve the document?s author in this case)
String name = myXmp.getAuthor();
System.out.println("The document?s author is " + name);
// Export the XMP metadata to an XML file
Document outDoc = xmpUt.exportXMP(inDoc);
File xmpFile = new File("c:\\LoanMetaData.xml");
outDoc.copyToFile(xmpFile);
}
catch (Exception e)
{
System.out.println("Error occurred: " + e.getMessage());
}
}
}
快速入門(SOAP模式)：使用Java API匯入XMP中繼資料 quick-start-soap-mode-importing-xmp-metadata-using-the-java-api
下列程式碼範例會匯入XMP中繼資料，並將新的PDF檔案儲存至磁碟。 PDF檔案是以名為Loan.pdf的PDF檔案為基礎。 包含要匯入PDF檔案之中繼資料的XML檔案，是以名為 LoanMetaData.xml 的XML檔案為基礎。 如需有關此XML檔案的資訊，請參閱將中繼資料匯入PDF檔案。
/*
* This Java Quick Start uses the following JAR files
* 1. adobe-pdfutility-client.jar
* 2. adobe-livecycle-client.jar
* 3. adobe-usermanager-client.jar
* 4. activation.jar (required for SOAP mode)
* 5. axis.jar (required for SOAP mode)
* 6. commons-codec-1.3.jar (required for SOAP mode)
* 7. commons-collections-3.2.jar (required for SOAP mode)
* 8. commons-discovery.jar (required for SOAP mode)
* 9. commons-logging.jar (required for SOAP mode)
* 10. dom3-xml-apis-2.5.0.jar (required for SOAP mode)
* 11. jaxen-1.1-beta-9.jar (required for SOAP mode)
* 12. jaxrpc.jar (required for SOAP mode)
* 13. log4j.jar (required for SOAP mode)
* 14. mail.jar (required for SOAP mode)
* 15. saaj.jar (required for SOAP mode)
* 16. wsdl4j.jar (required for SOAP mode)
* 17. xalan.jar (required for SOAP mode)
* 18. xbean.jar (required for SOAP mode)
* 19. xercesImpl.jar (required for SOAP mode)
*
* The JBoss files must be kept in the jboss\client folder. You can copy the client folder to
* your local development environment and then include the 3 JBoss JAR files in your class path
*
* These JAR files are in the following path:
* <install directory>/sdk/client-libs/common
*
*
* <install directory>/jboss/bin/client
*
* If you want to invoke a remote Forms Server instance and there is a
* firewall between the client application and the server, then it is
* recommended that you use the SOAP mode. When using the SOAP mode,
* you have to include additional JAR files in the following
* path
* <install directory>/sdk/client-libs/thirdparty
*
* For information about the SOAP
* mode and the additional JAR files that need to be included,
* see "Setting connection properties" in Programming
* with AEM Forms
*
* For complete details about the location of the AEM Forms JAR files,
* see "Including AEM Forms Java library files" in Programming
* with AEM Forms
*/
import com.adobe.livecycle.xmputility.*;
import com.adobe.livecycle.xmputility.client.*;
import java.util.*;
import java.io.*;
import com.adobe.idp.Document;
import com.adobe.idp.dsc.clientsdk.ServiceClientFactory;
import com.adobe.idp.dsc.clientsdk.ServiceClientFactoryProperties;
public class ImportMetadata
{
public static void main(String[] args)
{
try
{
//Set connection properties required to invoke AEM Forms
Properties connectionProps = new Properties();
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT, "https://'[server]:[port]'");
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL);
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");
//Create a ServiceClientFactory instance
ServiceClientFactory factory = ServiceClientFactory.createInstance(connectionProps);
//Create a XMP Utility client
XMPUtilityServiceClient xmpUt = new XMPUtilityServiceClient(factory);
//Specify a PDF document into which XMP metadata is imported
FileInputStream filePDF = new FileInputStream("C:\\Adobe\Loan.pdf");
Document inDoc = new Document(filePDF);
//Specify an XML file containing XMP metadata to import
FileInputStream fileXML = new FileInputStream("C:\\Adobe\LoanMetaData.xml");
Document xmpDoc = new Document(fileXML );
//Import the XMP metadata
Document outDoc = xmpUt.importXMP(inDoc, xmpDoc);
//Inspect the XMP metadata object (retrieve the document?s author in this case)
XMPUtilityMetadata myXmp = xmpUt.exportMetadata(outDoc);
String name = myXmp.getAuthor();
System.out.println("The document?s author is " + name);
//Save the PDF document containing the new metadata
File pdfFile = new File("c:\\Adobe\LoanWithMetadata.pdf");
outDoc.copyToFile(pdfFile);
}
catch (Exception e)
{
System.out.println("Error occurred: " + e.getMessage());
}
}
}
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2