1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132
/* * @(#)LDAPCertStoreParameters.java 1.9 05/11/17 * * Copyright 2006 Sun Microsystems, Inc. All rights reserved. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. */ package java.security.cert; /** * Parameters used as input for the LDAP <code>CertStore</code> algorithm. * <p> * This class is used to provide necessary configuration parameters (server * name and port number) to implementations of the LDAP <code>CertStore</code> * algorithm. * <p> * <b>Concurrent Access</b> * <p> * Unless otherwise specified, the methods defined in this class are not * thread-safe. Multiple threads that need to access a single * object concurrently should synchronize amongst themselves and * provide the necessary locking. Multiple threads each manipulating * separate objects need not synchronize. * * @version 1.9 11/17/05 * @since 1.4 * @author Steve Hanna * @see CertStore */ public class LDAPCertStoreParameters implements CertStoreParameters { private static final int LDAP_DEFAULT_PORT = 389; /** * the port number of the LDAP server */ private int port; /** * the DNS name of the LDAP server */ private String serverName; /** * Creates an instance of <code>LDAPCertStoreParameters</code> with the * specified parameter values. * * @param serverName the DNS name of the LDAP server * @param port the port number of the LDAP server * @exception NullPointerException if <code>serverName</code> is * <code>null</code> */ public LDAPCertStoreParameters(String serverName, int port) { if (serverName == null) throw new NullPointerException(); this.serverName = serverName; this.port = port; } /** * Creates an instance of <code>LDAPCertStoreParameters</code> with the * specified server name and a default port of 389. * * @param serverName the DNS name of the LDAP server * @exception NullPointerException if <code>serverName</code> is * <code>null</code> */ public LDAPCertStoreParameters(String serverName) { this(serverName, LDAP_DEFAULT_PORT); } /** * Creates an instance of <code>LDAPCertStoreParameters</code> with the * default parameter values (server name "localhost", port 389). */ public LDAPCertStoreParameters() { this("localhost", LDAP_DEFAULT_PORT); } /** * Returns the DNS name of the LDAP server. * * @return the name (not <code>null</code>) */ public String getServerName() { return serverName; } /** * Returns the port number of the LDAP server. * * @return the port number */ public int getPort() { return port; } /** * Returns a copy of this object. Changes to the copy will not affect * the original and vice versa. * <p> * Note: this method currently performs a shallow copy of the object * (simply calls <code>Object.clone()</code>). This may be changed in a * future revision to perform a deep copy if new parameters are added * that should not be shared. * * @return the copy */ public Object clone() { try { return super.clone(); } catch (CloneNotSupportedException e) { /* Cannot happen */ throw new InternalError(e.toString()); } } /** * Returns a formatted string describing the parameters. * * @return a formatted string describing the parameters */ public String toString() { StringBuffer sb = new StringBuffer(); sb.append("LDAPCertStoreParameters: [\n"); sb.append(" serverName: " + serverName + "\n"); sb.append(" port: " + port + "\n"); sb.append("]"); return sb.toString(); } }