Oracle Coherence for C++ API
Release 3.6.0.0

E15728-01

coherence/util/extractor/ReflectionUpdater.hpp

00001 /*
00002 * ReflectionUpdater.hpp
00003 *
00004 * Copyright (c) 2000, 2010, Oracle and/or its affiliates. All rights reserved.
00005 *
00006 * Oracle is a registered trademarks of Oracle Corporation and/or its
00007 * affiliates.
00008 *
00009 * This software is the confidential and proprietary information of Oracle
00010 * Corporation. You shall not disclose such confidential and proprietary
00011 * information and shall use it only in accordance with the terms of the
00012 * license agreement you entered into with Oracle.
00013 *
00014 * This notice may not be removed or altered.
00015 */
00016 #ifndef COH_REFLECTION_UPDATER_HPP
00017 #define COH_REFLECTION_UPDATER_HPP
00018 
00019 #include "coherence/lang.ns"
00020 
00021 #include "coherence/io/pof/PofReader.hpp"
00022 #include "coherence/io/pof/PofWriter.hpp"
00023 #include "coherence/io/pof/PortableObject.hpp"
00024 #include "coherence/util/ValueUpdater.hpp"
00025 
00026 COH_OPEN_NAMESPACE3(coherence,util,extractor)
00027 
00028 using coherence::io::pof::PofReader;
00029 using coherence::io::pof::PofWriter;
00030 using coherence::io::pof::PortableObject;
00031 
00032 
00033 /**
00034 * Reflection-based ValueUpdater implementation.
00035 *
00036 * ReflectionUpdater cannot be executed against local C++ caches, only
00037 * against remote caches. Locally executable C++ updaters may either be
00038 * custom built, or auto-generated via TypedUpdater<>.
00039 *
00040 * @author djl 2008.04.08
00041 *
00042 * @see CompositeUpdater
00043 * @see TypedUpdater
00044 */
00045 class COH_EXPORT ReflectionUpdater
00046     : public cloneable_spec<ReflectionUpdater,
00047         extends<Object>,
00048         implements<ValueUpdater, PortableObject> >
00049     {
00050     friend class factory<ReflectionUpdater>;
00051 
00052     // ----- constructors ---------------------------------------------------
00053 
00054     protected:
00055         /**
00056         * Construct an empty ReflectionUpdater
00057         * (necessary for the PortableObject interface).
00058         */
00059         ReflectionUpdater();
00060 
00061         /**
00062         * Construct a ReflectionUpdater for a given method name. This
00063         * implementation assumes that the corresponding classes will have one
00064         * and only one method with a specified name and this method will have
00065         * exactly one parameter.
00066         */
00067         ReflectionUpdater(String::View vsMethod);
00068 
00069         /**
00070         * Copy constructor.
00071         */
00072         ReflectionUpdater(const ReflectionUpdater& that);
00073 
00074 
00075     // ----- ValueUpdater interface ------------------------------------------
00076 
00077     public:
00078         /**
00079         * {@inheritDoc}
00080         *
00081         * @throws UnsupportedOperationException always
00082         */
00083         virtual void update(Object::Handle hTarget,
00084                 Object::Holder ohValue) const;
00085 
00086 
00087     // ----- PortableObject interface ---------------------------------------
00088 
00089     public:
00090         /**
00091         * {@inheritDoc}
00092         */
00093         virtual void readExternal(PofReader::Handle hIn);
00094 
00095         /**
00096         * {@inheritDoc}
00097         */
00098         virtual void writeExternal(PofWriter::Handle hOut) const;
00099 
00100 
00101     // ----- Object interface -----------------------------------------------
00102 
00103     public:
00104         /**
00105         * {@inheritDoc}
00106         */
00107         virtual bool equals(Object::View v) const;
00108 
00109         /**
00110         * {@inheritDoc}
00111         */
00112         virtual size32_t hashCode() const;
00113 
00114         /**
00115         * {@inheritDoc}
00116         */
00117         virtual void toStream(std::ostream& out) const;
00118 
00119 
00120     // ----- data member accessors ------------------------------------------
00121 
00122     public:
00123         /**
00124         * Determine the name of the method that this extractor is configured
00125         * to invoke.
00126         *
00127         * @return the name of the method to invoke using reflection
00128         */
00129         virtual String::View getMethodName() const;
00130 
00131 
00132     // ----- data members ---------------------------------------------------
00133 
00134     protected:
00135         /**
00136         * The name of the method to invoke.
00137         */
00138         MemberView<String> m_vsMethod;
00139     };
00140 
00141 COH_CLOSE_NAMESPACE3
00142 
00143 #endif // COH_REFLECTION_UPDATER_HPP
Copyright © 2000, 2010, Oracle and/or its affiliates. All rights reserved.