public PDMetadata(PDDocument document) 
{
        super( document );
        getStream().setName( "Type", "Metadata" );
        getStream().setName( "Subtype", "XML" );
}

This will create a new PDMetadata object.

Parameters:

document - The document that the stream will be part of.

 public PDMetadata(COSStream str) 
{
        super( str );
}

Constructor.

Parameters:

str - The stream parameter.

 public PDMetadata(PDDocument doc,
    InputStream str,
    boolean filtered) throws IOException 
{
        super( doc, str, filtered );
        getStream().setName( "Type", "Metadata" );
        getStream().setName( "Subtype", "XML" );
}

Constructor. Reads all data from the input stream and embeds it into the document, this will close the InputStream.

Parameters:

doc - The document that will hold the stream.

str - The stream parameter.

filtered - True if the stream already has a filter applied.

Throws:

IOException - If there is an error creating the stream in the document.

 public XMPMetadata exportXMPMetadata() throws IOException 
{
        return XMPMetadata.load( createInputStream() );
}

Extract the XMP metadata and create and build an in memory object. To persist changes back to the PDF you must call importXMPMetadata.

 public  void importXMPMetadata(XMPMetadata xmp) throws IOException, TransformerException 
{
        xmp.save( createOutputStream() );
}

Import an XMP stream into the PDF document.