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_BOX_UPDATER_HPP 00008 #define COH_BOX_UPDATER_HPP 00009 00010 #include "coherence/lang.ns" 00011 00012 #include "coherence/util/extractor/TypedUpdater.hpp" 00013 00014 COH_OPEN_NAMESPACE3(coherence,util,extractor) 00015 00016 00017 /** 00018 * Template based auto-boxing ValueUpdater implementation. 00019 * 00020 * This updater functions on non-const methods which take unmanaged types for 00021 * which there is a corresponding the is a managed type which can "box" 00022 * them via a BoxHandle. 00023 * 00024 * For ease of use the COH_BOX_UPDATER macro can be used to easily construct 00025 * an instance of this class. For example the following constructs an updater 00026 * for calling the "void Address::setZip(int32_t)" method. 00027 * 00028 * @code 00029 * ValueUpdater::View vUpd = COH_BOX_UPDATER(Address, setZip, Integer32::View); 00030 * @endcode 00031 * 00032 * In the case that the supplied class does not extend from Object and instead 00033 * relies on the Managed<> wrapper, the COH_MANAGED_BOX_UPDATER is to be 00034 * used. 00035 * 00036 * @author mf 2009.07.29 00037 * 00038 * @see TypedUpdater 00039 */ 00040 template<class AH, class C, void (C::*M)(typename AH::ValueType::BoxedType), 00041 class OH = typename C::Handle> 00042 class BoxUpdater 00043 : public class_spec<BoxUpdater<AH, C, M, OH>, 00044 extends<TypedUpdater<typename AH::ValueType::BoxedType, C, M, 00045 BoxHandle<typename AH::ValueType>, OH> > > 00046 { 00047 friend class factory<BoxUpdater<AH, C, M, OH> >; 00048 00049 // ----- constructors --------------------------------------------------- 00050 00051 protected: 00052 /** 00053 * Construct a BoxUpdater 00054 */ 00055 BoxUpdater() 00056 { 00057 } 00058 00059 /** 00060 * Construct a BoxUpdater based on a method name and optional 00061 * parameters. 00062 * 00063 * The method name is only used for the purposes of serializing the 00064 * extractor for execution on remote Java members. 00065 * 00066 * @param vsMethod the name of the method to invoke via reflection 00067 */ 00068 BoxUpdater(String::View vsMethod) 00069 : class_spec<BoxUpdater<AH, C, M, OH>, 00070 extends<TypedUpdater<typename AH::ValueType::BoxedType, C, M, 00071 BoxHandle<typename AH::ValueType>, OH> > >(vsMethod) 00072 { 00073 } 00074 }; 00075 00076 COH_CLOSE_NAMESPACE3 00077 00078 /** 00079 * Helper macro for creating a BoxUpdater. 00080 * 00081 * @param C the class to call the method on, i.e. Address 00082 * @param M the method to call, i.e. setZip 00083 * @param A the argument handle type to unbox from, i.e. Integer32::View 00084 */ 00085 #define COH_BOX_UPDATER(C, M, A) \ 00086 coherence::util::extractor::BoxUpdater<A, C, &C::M>::create(#M) 00087 00088 /** 00089 * Helper macro for creating a BoxUpdater around a Managed<> wrapped class. 00090 * 00091 * @param C the Managed<> wrapped class to call the method on, i.e. Address 00092 * @param M the method to call, i.e. setZip 00093 * @param A the argument handle type to unbox from, i.e. Integer32::View 00094 */ 00095 #define COH_MANAGED_BOX_UPDATER(C, M, A) \ 00096 coherence::util::extractor::BoxUpdater<A, C, &C::M, \ 00097 coherence::lang::Managed<C>::Handle>::create(#M) 00098 00099 #endif // COH_BOX_UPDATER_HPP