00001 /* 00002 * Copyright (c) 2000, 2020, Oracle and/or its affiliates. 00003 * 00004 * Licensed under the Universal Permissive License v 1.0 as shown at 00005 * http://oss.oracle.com/licenses/upl. 00006 */ 00007 #ifndef COH_VERSIONABLE_HPP 00008 #define COH_VERSIONABLE_HPP 00009 00010 #include "coherence/lang.ns" 00011 00012 COH_OPEN_NAMESPACE2(coherence,util) 00013 00014 00015 /** 00016 * An interface for versionable data. 00017 * 00018 * @author tb 2008.05.08 00019 */ 00020 class COH_EXPORT Versionable 00021 : public interface_spec<Versionable> 00022 { 00023 // ----- Versionable interface ------------------------------------------ 00024 00025 public: 00026 /** 00027 * Get the version indicator for this object. The version indicator 00028 * should be an immutable object or one treated as an immutable, which 00029 * is to say that after the version is incremented, the previous version's 00030 * indicator reference will never be returned again. 00031 * 00032 * @return a non-null version value that implements the Comparable 00033 * interface 00034 */ 00035 virtual Comparable::View getVersionIndicator() const = 0; 00036 00037 /** 00038 * Update the version to the next logical version indicator. 00039 * 00040 * @throws UnsupportedOperationException if the object is immutable or 00041 * if the object does not know how to increment its own version 00042 * indicator 00043 */ 00044 virtual void incrementVersion() = 0; 00045 }; 00046 00047 COH_CLOSE_NAMESPACE2 00048 00049 #endif // COH_VERSIONABLE_HPP 00050