001: /* ====================================================================
002: * The LateralNZ Software License, Version 1.0
003: *
004: * Copyright (c) 2003 LateralNZ. All rights reserved.
005: *
006: * Redistribution and use in source and binary forms, with or without
007: * modification, are permitted provided that the following conditions
008: * are met:
009: *
010: * 1. Redistributions of source code must retain the above copyright
011: * notice, this list of conditions and the following disclaimer.
012: *
013: * 2. Redistributions in binary form must reproduce the above copyright
014: * notice, this list of conditions and the following disclaimer in
015: * the documentation and/or other materials provided with the
016: * distribution.
017: *
018: * 3. The end-user documentation included with the redistribution,
019: * if any, must include the following acknowledgment:
020: * "This product includes software developed by
021: * LateralNZ (http://www.lateralnz.org/) and other third parties."
022: * Alternately, this acknowledgment may appear in the software itself,
023: * if and wherever such third-party acknowledgments normally appear.
024: *
025: * 4. The names "LateralNZ" must not be used to endorse or promote
026: * products derived from this software without prior written
027: * permission. For written permission, please
028: * contact oss@lateralnz.org.
029: *
030: * 5. Products derived from this software may not be called "Panther",
031: * or "Lateral" or "LateralNZ", nor may "PANTHER" or "LATERAL" or
032: * "LATERALNZ" appear in their name, without prior written
033: * permission of LateralNZ.
034: *
035: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
036: * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
037: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
038: * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
039: * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
040: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
041: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
042: * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
043: * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
044: * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
045: * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
046: * SUCH DAMAGE.
047: * ====================================================================
048: *
049: * This software consists of voluntary contributions made by many
050: * individuals on behalf of LateralNZ. For more
051: * information on Lateral, please see http://www.lateralnz.com/ or
052: * http://www.lateralnz.org
053: *
054: */
055: package org.lateralnz.common.model;
056:
057: import java.io.Serializable;
058:
059: import org.lateralnz.common.util.Constants;
060: import org.lateralnz.common.util.StringUtils;
061:
062: /**
063: * a key 'holder' containing primary key, plus secondary key data
064: */
065: public class CompositeKey implements Serializable, Constants {
066: private String primaryKey;
067: private String[] secondaryKeys;
068: private String[] allKeys;
069:
070: public CompositeKey(String primaryKey, String[] secondaryKeys) {
071: this .primaryKey = primaryKey;
072: setSecondaryKeys(secondaryKeys);
073: }
074:
075: /**
076: * set the array of secondard keys for this composite
077: */
078: public void setSecondaryKeys(String[] secondaryKeys) {
079: this .secondaryKeys = secondaryKeys;
080: if (secondaryKeys == null) {
081: secondaryKeys = new String[] {};
082: }
083: allKeys = new String[secondaryKeys.length + 1];
084: allKeys[0] = primaryKey;
085: System.arraycopy(secondaryKeys, 0, allKeys, 1,
086: secondaryKeys.length);
087: }
088:
089: /**
090: * get the primary key for this composite
091: */
092: public String getPrimaryKey() {
093: return primaryKey;
094: }
095:
096: /**
097: * get the array of secondary keys for this composite
098: */
099: public String[] getSecondaryKeys() {
100: return secondaryKeys;
101: }
102:
103: /**
104: * get an array of all keys in this composite. Note: the primary
105: * key is always the first member of this array
106: */
107: public String[] getAllKeys() {
108: return allKeys;
109: }
110:
111: /**
112: * returns true if the specified object is the same as this composite
113: */
114: public boolean equals(Object obj) {
115: CompositeKey ck = (CompositeKey) obj;
116: int len = getAllKeys().length;
117: if (len != ck.getAllKeys().length) {
118: return false;
119: } else {
120: for (int i = 0; i < len; i++) {
121: if (!StringUtils.isEqual(getAllKeys()[i], ck
122: .getAllKeys()[i])) {
123: return false;
124: }
125: }
126: return true;
127: }
128: }
129:
130: public String toString() {
131: StringBuffer sb = new StringBuffer();
132: int len = getAllKeys().length;
133: int offlen = len - 1;
134: for (int i = 0; i < len; i++) {
135: sb.append(getAllKeys()[i]);
136: if (i < offlen) {
137: sb.append(COMMA);
138: }
139: }
140: return sb.toString();
141: }
142: }
|