1. /*
  2. * $Header: /home/cvs/jakarta-commons/primitives/src/java/org/apache/commons/collections/primitives/adapters/CollectionShortCollection.java,v 1.3 2003/10/16 20:49:38 scolebourne Exp $
  3. * ====================================================================
  4. * The Apache Software License, Version 1.1
  5. *
  6. * Copyright (c) 2003 The Apache Software Foundation. All rights
  7. * reserved.
  8. *
  9. * Redistribution and use in source and binary forms, with or without
  10. * modification, are permitted provided that the following conditions
  11. * are met:
  12. *
  13. * 1. Redistributions of source code must retain the above copyright
  14. * notice, this list of conditions and the following disclaimer.
  15. *
  16. * 2. Redistributions in binary form must reproduce the above copyright
  17. * notice, this list of conditions and the following disclaimer in
  18. * the documentation and/or other materials provided with the
  19. * distribution.
  20. *
  21. * 3. The end-user documentation included with the redistribution, if
  22. * any, must include the following acknowledgement:
  23. * "This product includes software developed by the
  24. * Apache Software Foundation (http://www.apache.org/)."
  25. * Alternately, this acknowledgement may appear in the software itself,
  26. * if and wherever such third-party acknowledgements normally appear.
  27. *
  28. * 4. The names "The Jakarta Project", "Commons", and "Apache Software
  29. * Foundation" must not be used to endorse or promote products derived
  30. * from this software without prior written permission. For written
  31. * permission, please contact apache@apache.org.
  32. *
  33. * 5. Products derived from this software may not be called "Apache"
  34. * nor may "Apache" appear in their names without prior written
  35. * permission of the Apache Software Foundation.
  36. *
  37. * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  38. * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  39. * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  40. * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  41. * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  42. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  43. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  44. * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  45. * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  46. * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  47. * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  48. * SUCH DAMAGE.
  49. * ====================================================================
  50. *
  51. * This software consists of voluntary contributions made by many
  52. * individuals on behalf of the Apache Software Foundation. For more
  53. * information on the Apache Software Foundation, please see
  54. * <http://www.apache.org/>.
  55. *
  56. */
  57. package org.apache.commons.collections.primitives.adapters;
  58. import java.io.Serializable;
  59. import java.util.Collection;
  60. import org.apache.commons.collections.primitives.ShortCollection;
  61. /**
  62. * Adapts a {@link java.lang.Number Number}-valued
  63. * {@link java.util.Collection Collection} to the
  64. * {@link ShortCollection ShortCollection} interface.
  65. * <p />
  66. * This implementation delegates most methods
  67. * to the provided {@link Collection Collection}
  68. * implementation in the "obvious" way.
  69. *
  70. * @since Commons Primitives 1.0
  71. * @version $Revision: 1.3 $ $Date: 2003/10/16 20:49:38 $
  72. * @author Rodney Waldhoff
  73. */
  74. final public class CollectionShortCollection extends AbstractCollectionShortCollection implements Serializable {
  75. /**
  76. * Create an {@link ShortCollection ShortCollection} wrapping
  77. * the specified {@link Collection Collection}. When
  78. * the given <i>collection</i> is <code>null</code>,
  79. * returns <code>null</code>.
  80. *
  81. * @param collection the (possibly <code>null</code>) {@link Collection} to wrap
  82. * @return an {@link ShortCollection ShortCollection} wrapping the given
  83. * <i>collection</i>, or <code>null</code> when <i>collection</i> is
  84. * <code>null</code>.
  85. */
  86. public static ShortCollection wrap(Collection collection) {
  87. if(null == collection) {
  88. return null;
  89. } else if(collection instanceof Serializable) {
  90. return new CollectionShortCollection(collection);
  91. } else {
  92. return new NonSerializableCollectionShortCollection(collection);
  93. }
  94. }
  95. /**
  96. * Creates an {@link ShortCollection ShortCollection} wrapping
  97. * the specified {@link Collection Collection}.
  98. * @see #wrap
  99. */
  100. public CollectionShortCollection(Collection collection) {
  101. _collection = collection;
  102. }
  103. protected Collection getCollection() {
  104. return _collection;
  105. }
  106. private Collection _collection = null;
  107. }