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_SERVICE_HPP 00008 #define COH_SERVICE_HPP 00009 00010 #include "coherence/lang.ns" 00011 00012 #include "coherence/util/Controllable.hpp" 00013 #include "coherence/util/ServiceListener.hpp" 00014 00015 COH_OPEN_NAMESPACE2(coherence,util) 00016 00017 00018 /** 00019 * A Service is a Controllable that emits service lifecycle events. 00020 * 00021 * @see ServiceListener 00022 * 00023 * @author jh 2007.12.12 00024 */ 00025 class COH_EXPORT Service 00026 : public interface_spec<Service, 00027 implements<Controllable> > 00028 { 00029 // ----- Service interface ---------------------------------------------- 00030 00031 public: 00032 /** 00033 * Register a ServiceListener that will receive events pertaining to 00034 * the lifecycle of this Service. 00035 * 00036 * @param hListener the new ServiceListener to register; if the 00037 * listener has already been registered, this 00038 * method has no effect 00039 */ 00040 virtual void addServiceListener(ServiceListener::Handle hListener) = 0; 00041 00042 /** 00043 * Unregister a ServiceListener from this ConnectionManager. 00044 * 00045 * After a ServiceListener is removed, it will no longer receive 00046 * events pertaining to the lifecycle of this Service. 00047 * 00048 * @param hListener the ServiceListener to deregister; if the 00049 * listener has not previously been registered, 00050 * this method has no effect 00051 */ 00052 virtual void removeServiceListener(ServiceListener::Handle hListener) = 0; 00053 }; 00054 00055 COH_CLOSE_NAMESPACE2 00056 00057 #endif // COH_SERVICE_HPP