01: /**
02: * Copyright (c) 2003-2005, www.pdfbox.org
03: * All rights reserved.
04: *
05: * Redistribution and use in source and binary forms, with or without
06: * modification, are permitted provided that the following conditions are met:
07: *
08: * 1. Redistributions of source code must retain the above copyright notice,
09: * this list of conditions and the following disclaimer.
10: * 2. Redistributions in binary form must reproduce the above copyright notice,
11: * this list of conditions and the following disclaimer in the documentation
12: * and/or other materials provided with the distribution.
13: * 3. Neither the name of pdfbox; nor the names of its
14: * contributors may be used to endorse or promote products derived from this
15: * software without specific prior written permission.
16: *
17: * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
18: * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
20: * DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY
21: * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
22: * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
23: * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
24: * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25: * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
26: * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27: *
28: * http://www.pdfbox.org
29: *
30: */package org.pdfbox.pdmodel.encryption;
31:
32: /**
33: * This class represents the protection policy to apply to a document.
34: *
35: * Objects implementing this abstract class can be passed to the protect method of PDDocument
36: * to protect a document.
37: *
38: * @see org.pdfbox.pdmodel.PDDocument#protect(ProtectionPolicy)
39: *
40: * @author Benoit Guillon (benoit.guillon@snv.jussieu.fr)
41: * @version $Revision: 1.2 $
42: */
43: public abstract class ProtectionPolicy {
44:
45: private static final int DEFAULT_KEY_LENGTH = 40;
46:
47: private int encryptionKeyLength = DEFAULT_KEY_LENGTH;
48:
49: /**
50: * set the length in (bits) of the secret key that will be
51: * used to encrypt document data.
52: * The default value is 40 bits, which provides a low security level
53: * but is compatible with old versions of Acrobat Reader.
54: *
55: * @param l the length in bits (must be 40 or 128)
56: */
57: public void setEncryptionKeyLength(int l) {
58: if (l != 40 && l != 128) {
59: throw new RuntimeException("Invalid key length");
60: }
61: encryptionKeyLength = l;
62: }
63:
64: /**
65: * Get the length of the secrete key that will be used to encrypt
66: * document data.
67: *
68: * @return The length (in bits) of the encryption key.
69: */
70: public int getEncryptionKeyLength() {
71: return encryptionKeyLength;
72: }
73: }
|