View Javadoc
1   /*
2    * Licensed to The Apereo Foundation under one or more contributor license
3    * agreements. See the NOTICE file distributed with this work for additional
4    * information regarding copyright ownership.
5    *
6    *
7    * The Apereo Foundation licenses this file to you under the Educational
8    * Community License, Version 2.0 (the "License"); you may not use this file
9    * except in compliance with the License. You may obtain a copy of the License
10   * at:
11   *
12   *   http://opensource.org/licenses/ecl2.txt
13   *
14   * Unless required by applicable law or agreed to in writing, software
15   * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
16   * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the
17   * License for the specific language governing permissions and limitations under
18   * the License.
19   *
20   */
21  package org.opencastproject.assetmanager.api;
22  
23  import java.io.Serializable;
24  
25  /**
26   * The version of an archived media package or element.
27   * Versions have a natural order where v1 < v2 means that v1 is older that v2.
28   */
29  public interface Version extends Comparable<Version>, Serializable {
30    /** Check if this version is older than <code>v</code>. */
31    boolean isOlder(Version v);
32  
33    /** Check if this version is younger than <code>v</code>. */
34    boolean isYounger(Version v);
35  
36    /** A version must implement hashCode and equals. */
37    boolean equals(Object that);
38  
39    /** A version must implement hashCode and equals. */
40    int hashCode();
41  
42    /**
43     * Serialize to a string. This is the inverse function of
44     * {@link org.opencastproject.assetmanager.api.AssetManager#toVersion(String)}.
45     */
46    String toString();
47  }