Initial import of release 2.2.REL-2.2@923

git-svn-id: https://joinup.ec.europa.eu/svn/pdf-as/trunk@4 7b5415b0-85f9-ee4d-85bd-d5d0c3b42d1c

5 files changed, 811 insertions, 0 deletions

diff --git a/src/main/java/org/pdfbox/pdmodel/common/filespecification/PDComplexFileSpecification.java b/src/main/java/org/pdfbox/pdmodel/common/filespecification/PDComplexFileSpecification.java
new file mode 100644
index 0000000..12618f1
--- /dev/null
+++ b/src/main/java/org/pdfbox/pdmodel/common/filespecification/PDComplexFileSpecification.java
@@ -0,0 +1,326 @@
+/**

+ * Copyright (c) 2004-2005, www.pdfbox.org

+ * All rights reserved.

+ *

+ * Redistribution and use in source and binary forms, with or without

+ * modification, are permitted provided that the following conditions are met:

+ *

+ * 1. Redistributions of source code must retain the above copyright notice,

+ *    this list of conditions and the following disclaimer.

+ * 2. Redistributions in binary form must reproduce the above copyright notice,

+ *    this list of conditions and the following disclaimer in the documentation

+ *    and/or other materials provided with the distribution.

+ * 3. Neither the name of pdfbox; nor the names of its

+ *    contributors may be used to endorse or promote products derived from this

+ *    software without specific prior written permission.

+ *

+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"

+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

+ * DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY

+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON

+ * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

+ *

+ * http://www.pdfbox.org

+ *

+ */

+package org.pdfbox.pdmodel.common.filespecification;

+

+import org.pdfbox.cos.COSBase;

+import org.pdfbox.cos.COSDictionary;

+import org.pdfbox.cos.COSStream;

+

+/**

+ * This represents a file specification.

+ *

+ * @author Ben Litchfield (ben@benlitchfield.com)

+ * @version $Revision: 1.3 $

+ */

+public class PDComplexFileSpecification extends PDFileSpecification

+{

+    private COSDictionary fs;

+

+    /**

+     * Default Constructor.

+     */

+    public PDComplexFileSpecification()

+    {

+        fs = new COSDictionary();

+        fs.setName( "Type", "Filespec" );

+    }

+

+    /**

+     * Constructor.

+     *

+     * @param dict The dictionary that fulfils this file specification.

+     */

+    public PDComplexFileSpecification( COSDictionary dict )

+    {

+        fs = dict;

+    }

+

+    /**

+     * Convert this standard java object to a COS object.

+     *

+     * @return The cos object that matches this Java object.

+     */

+    public COSBase getCOSObject()

+    {

+        return fs;

+    }

+

+    /**

+     * Convert this standard java object to a COS object.

+     *

+     * @return The cos object that matches this Java object.

+     */

+    public COSDictionary getCOSDictionary()

+    {

+        return fs;

+    }

+

+    /**

+     * This will get the file name.

+     *

+     * @return The file name.

+     */

+    public String getFile()

+    {

+        return fs.getString( "F" );

+    }

+

+    /**

+     * This will set the file name.

+     *

+     * @param file The name of the file.

+     */

+    public void setFile( String file )

+    {

+        fs.setString( "F", file );

+    }

+    

+    /**

+     * This will get the name representing a Dos file.

+     *

+     * @return The file name.

+     */

+    public String getFileDos()

+    {

+        return fs.getString( "DOS" );

+    }

+

+    /**

+     * This will set name representing a dos file.

+     *

+     * @param file The name of the file.

+     */

+    public void setFileDos( String file )

+    {

+        fs.setString( "DOS", file );

+    }

+    

+    /**

+     * This will get the name representing a Mac file.

+     *

+     * @return The file name.

+     */

+    public String getFileMac()

+    {

+        return fs.getString( "Mac" );

+    }

+

+    /**

+     * This will set name representing a Mac file.

+     *

+     * @param file The name of the file.

+     */

+    public void setFileMac( String file )

+    {

+        fs.setString( "Mac", file );

+    }

+    

+    /**

+     * This will get the name representing a Unix file.

+     *

+     * @return The file name.

+     */

+    public String getFileUnix()

+    {

+        return fs.getString( "Unix" );

+    }

+

+    /**

+     * This will set name representing a Unix file.

+     *

+     * @param file The name of the file.

+     */

+    public void setFileUnix( String file )

+    {

+        fs.setString( "Unix", file );

+    }

+    

+    /**

+     * Tell if the underlying file is volatile and should not be cached by the

+     * reader application.  Default: false

+     * 

+     * @param fileIsVolatile The new value for the volatility of the file.

+     */

+    public void setVolatile( boolean fileIsVolatile )

+    {

+        fs.setBoolean( "V", fileIsVolatile );

+    }

+    

+    /**

+     * Get if the file is volatile.  Default: false

+     * 

+     * @return True if the file is volatile attribute is set.

+     */

+    public boolean isVolatile()

+    {

+        return fs.getBoolean( "V", false );

+    }

+    

+    /**

+     * Get the embedded file.

+     * 

+     * @return The embedded file for this file spec.

+     */

+    public PDEmbeddedFile getEmbeddedFile()

+    {

+        PDEmbeddedFile file = null;

+        COSStream stream = (COSStream)fs.getObjectFromPath( "EF/F" );

+        if( stream != null )

+        {

+            file = new PDEmbeddedFile( stream );

+        }

+        return file;

+    }

+    

+    /**

+     * Set the embedded file for this spec.

+     * 

+     * @param file The file to be embedded.

+     */

+    public void setEmbeddedFile( PDEmbeddedFile file )

+    {

+        COSDictionary ef = (COSDictionary)fs.getDictionaryObject( "EF" );

+        if( ef == null && file != null )

+        {

+            ef = new COSDictionary();

+            fs.setItem( "EF", ef );

+        }

+        if( ef != null )

+        {

+            ef.setItem( "F", file );

+        }

+    }

+    

+    /**

+     * Get the embedded dos file.

+     * 

+     * @return The embedded file for this file spec.

+     */

+    public PDEmbeddedFile getEmbeddedFileDos()

+    {

+        PDEmbeddedFile file = null;

+        COSStream stream = (COSStream)fs.getObjectFromPath( "EF/DOS" );

+        if( stream != null )

+        {

+            file = new PDEmbeddedFile( stream );

+        }

+        return file;

+    }

+    

+    /**

+     * Set the embedded dos file for this spec.

+     * 

+     * @param file The dos file to be embedded.

+     */

+    public void setEmbeddedFileDos( PDEmbeddedFile file )

+    {

+        COSDictionary ef = (COSDictionary)fs.getDictionaryObject( "DOS" );

+        if( ef == null && file != null )

+        {

+            ef = new COSDictionary();

+            fs.setItem( "EF", ef );

+        }

+        if( ef != null )

+        {

+            ef.setItem( "DOS", file );

+        }

+    }

+    

+    /**

+     * Get the embedded Mac file.

+     * 

+     * @return The embedded file for this file spec.

+     */

+    public PDEmbeddedFile getEmbeddedFileMac()

+    {

+        PDEmbeddedFile file = null;

+        COSStream stream = (COSStream)fs.getObjectFromPath( "EF/Mac" );

+        if( stream != null )

+        {

+            file = new PDEmbeddedFile( stream );

+        }

+        return file;

+    }

+    

+    /**

+     * Set the embedded Mac file for this spec.

+     * 

+     * @param file The Mac file to be embedded.

+     */

+    public void setEmbeddedFileMac( PDEmbeddedFile file )

+    {

+        COSDictionary ef = (COSDictionary)fs.getDictionaryObject( "Mac" );

+        if( ef == null && file != null )

+        {

+            ef = new COSDictionary();

+            fs.setItem( "EF", ef );

+        }

+        if( ef != null )

+        {

+            ef.setItem( "Mac", file );

+        }

+    }

+    

+    /**

+     * Get the embedded Unix file.

+     * 

+     * @return The embedded file for this file spec.

+     */

+    public PDEmbeddedFile getEmbeddedFileUnix()

+    {

+        PDEmbeddedFile file = null;

+        COSStream stream = (COSStream)fs.getObjectFromPath( "EF/Unix" );

+        if( stream != null )

+        {

+            file = new PDEmbeddedFile( stream );

+        }

+        return file;

+    }

+    

+    /**

+     * Set the embedded Unix file for this spec.

+     * 

+     * @param file The Unix file to be embedded.

+     */

+    public void setEmbeddedFileUnix( PDEmbeddedFile file )

+    {

+        COSDictionary ef = (COSDictionary)fs.getDictionaryObject( "Unix" );

+        if( ef == null && file != null )

+        {

+            ef = new COSDictionary();

+            fs.setItem( "EF", ef );

+        }

+        if( ef != null )

+        {

+            ef.setItem( "Unix", file );

+        }

+    }

+}
\ No newline at end of file
diff --git a/src/main/java/org/pdfbox/pdmodel/common/filespecification/PDEmbeddedFile.java b/src/main/java/org/pdfbox/pdmodel/common/filespecification/PDEmbeddedFile.java
new file mode 100644
index 0000000..1f4a288
--- /dev/null
+++ b/src/main/java/org/pdfbox/pdmodel/common/filespecification/PDEmbeddedFile.java
@@ -0,0 +1,298 @@
+/**

+ * Copyright (c) 2004, www.pdfbox.org

+ * All rights reserved.

+ *

+ * Redistribution and use in source and binary forms, with or without

+ * modification, are permitted provided that the following conditions are met:

+ *

+ * 1. Redistributions of source code must retain the above copyright notice,

+ *    this list of conditions and the following disclaimer.

+ * 2. Redistributions in binary form must reproduce the above copyright notice,

+ *    this list of conditions and the following disclaimer in the documentation

+ *    and/or other materials provided with the distribution.

+ * 3. Neither the name of pdfbox; nor the names of its

+ *    contributors may be used to endorse or promote products derived from this

+ *    software without specific prior written permission.

+ *

+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"

+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

+ * DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY

+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON

+ * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

+ *

+ * http://www.pdfbox.org

+ *

+ */

+package org.pdfbox.pdmodel.common.filespecification;

+

+import java.io.IOException;

+import java.io.InputStream;

+import java.util.Calendar;

+

+import org.pdfbox.cos.COSDictionary;

+import org.pdfbox.cos.COSStream;

+import org.pdfbox.pdmodel.PDDocument;

+import org.pdfbox.pdmodel.common.PDStream;

+

+/**

+ * This represents an embedded file in a file specification.

+ *

+ * @author Ben Litchfield (ben@benlitchfield.com)

+ * @version $Revision: 1.1 $

+ */

+public class PDEmbeddedFile extends PDStream

+{

+

+    /**

+     * @see PDStream#PDStream(PDDocument)

+     */

+    public PDEmbeddedFile( PDDocument document )

+    {

+        super( document );

+        getStream().setName( "Type", "EmbeddedFile" );

+        

+    }

+    

+    /**

+     * Constructor.

+     *

+     * @param str The stream parameter.

+     */

+    public PDEmbeddedFile( COSStream str )

+    {

+        super( str );

+    }

+    

+    /**

+     * @see PDStream#PDStream(PDDocument, InputStream )

+     */

+    public PDEmbeddedFile( PDDocument doc, InputStream str  ) throws IOException

+    {

+        super( doc, str );

+        getStream().setName( "Type", "EmbeddedFile" );

+    }

+    

+    /**

+     * @see PDStream#PDStream(PDDocument, InputStream, boolean)

+     */

+    public PDEmbeddedFile( PDDocument doc, InputStream str, boolean filtered ) throws IOException

+    {

+        super( doc, str, filtered );

+        getStream().setName( "Type", "EmbeddedFile" );

+    }

+    

+    /**

+     * Set the subtype for this embedded file.  This should be a mime type value.  Optional.

+     * 

+     * @param mimeType The mimeType for the file.

+     */

+    public void setSubtype( String mimeType )

+    {

+        getStream().setName( "Subtype", mimeType );

+    }

+    

+    /**

+     * Get the subtype(mimetype) for the embedded file.

+     * 

+     * @return The type of embedded file.

+     */

+    public String getSubtype()

+    {

+        return getStream().getNameAsString( "Subtype" );

+    }

+    

+    /**

+     * Get the size of the embedded file.

+     * 

+     * @return The size of the embedded file.

+     */

+    public int getSize()

+    {

+        return getStream().getEmbeddedInt( "Params", "Size" );

+    }

+    

+    /**

+     * Set the size of the embedded file.

+     * 

+     * @param size The size of the embedded file.

+     */

+    public void setSize( int size )

+    {

+        getStream().setEmbeddedInt( "Params", "Size", size );

+    }

+    

+    /**

+     * Get the creation date of the embedded file.

+     * 

+     * @return The Creation date.

+     * @throws IOException If there is an error while constructing the date.

+     */

+    public Calendar getCreationDate() throws IOException

+    {

+        return getStream().getEmbeddedDate( "Params", "CreationDate" );

+    }

+    

+    /**

+     * Set the creation date.

+     * 

+     * @param creation The new creation date.

+     */

+    public void setCreationDate( Calendar creation )

+    {

+        getStream().setEmbeddedDate( "Params", "CreationDate", creation );

+    }

+    

+    /**

+     * Get the mod date of the embedded file.

+     * 

+     * @return The mod date.

+     * @throws IOException If there is an error while constructing the date.

+     */

+    public Calendar getModDate() throws IOException

+    {

+        return getStream().getEmbeddedDate( "Params", "ModDate" );

+    }

+    

+    /**

+     * Set the mod date.

+     * 

+     * @param mod The new creation mod.

+     */

+    public void setModDate( Calendar mod )

+    {

+        getStream().setEmbeddedDate( "Params", "ModDate", mod );

+    }

+    

+    /**

+     * Get the check sum of the embedded file.

+     * 

+     * @return The check sum of the file.

+     */

+    public String getCheckSum()

+    {

+        return getStream().getEmbeddedString( "Params", "CheckSum" );

+    }

+    

+    /**

+     * Set the check sum.

+     * 

+     * @param checksum The checksum of the file.

+     */

+    public void setCheckSum( String checksum )

+    {

+        getStream().setEmbeddedString( "Params", "CheckSum", checksum );

+    }

+    

+    /**

+     * Get the mac subtype.

+     * 

+     * @return The mac subtype.

+     */

+    public String getMacSubtype()

+    {

+        String retval = null;

+        COSDictionary params = (COSDictionary)getStream().getDictionaryObject( "Params" );

+        if( params != null )

+        {

+            retval = params.getEmbeddedString( "Mac", "Subtype" );

+        }

+        return retval;

+    }

+    

+    /**

+     * Set the mac subtype.

+     * 

+     * @param macSubtype The mac subtype.

+     */

+    public void setMacSubtype( String macSubtype )

+    {

+        COSDictionary params = (COSDictionary)getStream().getDictionaryObject( "Params" );

+        if( params == null && macSubtype != null )

+        {

+            params = new COSDictionary();

+            getStream().setItem( "Params", params );

+        }

+        if( params != null )

+        {

+            params.setEmbeddedString( "Mac", "Subtype", macSubtype );

+        }

+    }

+    

+    /**

+     * Get the mac Creator.

+     * 

+     * @return The mac Creator.

+     */

+    public String getMacCreator()

+    {

+        String retval = null;

+        COSDictionary params = (COSDictionary)getStream().getDictionaryObject( "Params" );

+        if( params != null )

+        {

+            retval = params.getEmbeddedString( "Mac", "Creator" );

+        }

+        return retval;

+    }

+    

+    /**

+     * Set the mac Creator.

+     * 

+     * @param macCreator The mac Creator.

+     */

+    public void setMacCreator( String macCreator )

+    {

+        COSDictionary params = (COSDictionary)getStream().getDictionaryObject( "Params" );

+        if( params == null && macCreator != null )

+        {

+            params = new COSDictionary();

+            getStream().setItem( "Params", params );

+        }

+        if( params != null )

+        {

+            params.setEmbeddedString( "Mac", "Creator", macCreator );

+        }

+    }

+    

+    /**

+     * Get the mac ResFork.

+     * 

+     * @return The mac ResFork.

+     */

+    public String getMacResFork()

+    {

+        String retval = null;

+        COSDictionary params = (COSDictionary)getStream().getDictionaryObject( "Params" );

+        if( params != null )

+        {

+            retval = params.getEmbeddedString( "Mac", "ResFork" );

+        }

+        return retval;

+    }

+    

+    /**

+     * Set the mac ResFork.

+     * 

+     * @param macResFork The mac ResFork.

+     */

+    public void setMacResFork( String macResFork )

+    {

+        COSDictionary params = (COSDictionary)getStream().getDictionaryObject( "Params" );

+        if( params == null && macResFork != null )

+        {

+            params = new COSDictionary();

+            getStream().setItem( "Params", params );

+        }

+        if( params != null )

+        {

+            params.setEmbeddedString( "Mac", "ResFork", macResFork);

+        }

+    }

+    

+    

+    

+}
\ No newline at end of file
diff --git a/src/main/java/org/pdfbox/pdmodel/common/filespecification/PDFileSpecification.java b/src/main/java/org/pdfbox/pdmodel/common/filespecification/PDFileSpecification.java
new file mode 100644
index 0000000..2028247
--- /dev/null
+++ b/src/main/java/org/pdfbox/pdmodel/common/filespecification/PDFileSpecification.java
@@ -0,0 +1,83 @@
+/**

+ * Copyright (c) 2004, www.pdfbox.org

+ * All rights reserved.

+ *

+ * Redistribution and use in source and binary forms, with or without

+ * modification, are permitted provided that the following conditions are met:

+ *

+ * 1. Redistributions of source code must retain the above copyright notice,

+ *    this list of conditions and the following disclaimer.

+ * 2. Redistributions in binary form must reproduce the above copyright notice,

+ *    this list of conditions and the following disclaimer in the documentation

+ *    and/or other materials provided with the distribution.

+ * 3. Neither the name of pdfbox; nor the names of its

+ *    contributors may be used to endorse or promote products derived from this

+ *    software without specific prior written permission.

+ *

+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"

+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

+ * DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY

+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON

+ * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

+ *

+ * http://www.pdfbox.org

+ *

+ */

+package org.pdfbox.pdmodel.common.filespecification;

+

+import org.pdfbox.cos.COSBase;

+import org.pdfbox.cos.COSDictionary;

+import org.pdfbox.cos.COSString;

+

+import org.pdfbox.pdmodel.common.COSObjectable;

+

+/**

+ * This represents a file specification.

+ *

+ * @author Ben Litchfield (ben@csh.rit.edu)

+ * @version $Revision: 1.2 $

+ */

+public abstract class PDFileSpecification implements COSObjectable

+{

+

+    /**

+     * A file specfication can either be a COSString or a COSDictionary.  This

+     * will create the file specification either way.

+     *

+     * @param base The cos object that describes the fs.

+     *

+     * @return The file specification for the COSBase object.

+     */

+    public static PDFileSpecification createFS( COSBase base )

+    {

+        PDFileSpecification retval = null;

+        if( base instanceof COSString )

+        {

+            retval = new PDSimpleFileSpecification( (COSString)base );

+        }

+        else if( base instanceof COSDictionary )

+        {

+            retval = new PDComplexFileSpecification( (COSDictionary)base );

+        }

+        return retval;

+    }

+

+    /**

+     * This will get the file name.

+     *

+     * @return The file name.

+     */

+    public abstract String getFile();

+

+    /**

+     * This will set the file name.

+     *

+     * @param file The name of the file.

+     */

+    public abstract void setFile( String file );

+}
\ No newline at end of file
diff --git a/src/main/java/org/pdfbox/pdmodel/common/filespecification/PDSimpleFileSpecification.java b/src/main/java/org/pdfbox/pdmodel/common/filespecification/PDSimpleFileSpecification.java
new file mode 100644
index 0000000..b885a78
--- /dev/null
+++ b/src/main/java/org/pdfbox/pdmodel/common/filespecification/PDSimpleFileSpecification.java
@@ -0,0 +1,95 @@
+/**

+ * Copyright (c) 2004, www.pdfbox.org

+ * All rights reserved.

+ *

+ * Redistribution and use in source and binary forms, with or without

+ * modification, are permitted provided that the following conditions are met:

+ *

+ * 1. Redistributions of source code must retain the above copyright notice,

+ *    this list of conditions and the following disclaimer.

+ * 2. Redistributions in binary form must reproduce the above copyright notice,

+ *    this list of conditions and the following disclaimer in the documentation

+ *    and/or other materials provided with the distribution.

+ * 3. Neither the name of pdfbox; nor the names of its

+ *    contributors may be used to endorse or promote products derived from this

+ *    software without specific prior written permission.

+ *

+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"

+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE

+ * DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY

+ * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES

+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON

+ * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT

+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS

+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

+ *

+ * http://www.pdfbox.org

+ *

+ */

+package org.pdfbox.pdmodel.common.filespecification;

+

+import org.pdfbox.cos.COSBase;

+import org.pdfbox.cos.COSString;

+

+/**

+ * A file specification that is just a string.

+ * 

+ * @author blitchfield

+ * @version $Revision: 1.1 $

+ */

+public class PDSimpleFileSpecification extends PDFileSpecification

+{

+    private COSString file;

+    

+    /**

+     * Constructor.

+     *

+     */

+    public PDSimpleFileSpecification()

+    {

+        file = new COSString( "" );

+    }

+

+    /**

+     * Constructor.

+     * 

+     * @param fileName The file that this spec represents.

+     */

+    public PDSimpleFileSpecification( COSString fileName )

+    {

+        file = fileName;

+    }

+

+    /**

+     * This will get the file name.

+     *

+     * @return The file name.

+     */

+    public String getFile()

+    {

+    return file.getString();

+    }

+

+    /**

+     * This will set the file name.

+     *

+     * @param fileName The name of the file.

+     */

+    public void setFile( String fileName )

+    {

+    file = new COSString( fileName );

+    }

+    

+    /**

+     * Convert this standard java object to a COS object.

+     *

+     * @return The cos object that matches this Java object.

+     */

+    public COSBase getCOSObject()

+    {

+        return file;

+    }

+

+}

diff --git a/src/main/java/org/pdfbox/pdmodel/common/filespecification/package.html b/src/main/java/org/pdfbox/pdmodel/common/filespecification/package.html
new file mode 100644
index 0000000..ca87d22
--- /dev/null
+++ b/src/main/java/org/pdfbox/pdmodel/common/filespecification/package.html
@@ -0,0 +1,9 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">

+<html>

+<head>

+

+</head>

+<body>

+The file specification package defines classes that are used for the PDF File Specification logic.

+</body>

+</html>