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_NAME_SERVICE_HPP 00008 #define COH_NAME_SERVICE_HPP 00009 00010 #include "coherence/lang.ns" 00011 00012 #include "coherence/net/Service.hpp" 00013 00014 COH_OPEN_NAMESPACE2(coherence,net) 00015 00016 /** 00017 * A NameService is a clustered service that accepts connections from 00018 * external clients (e.g. Coherence*Extend) and provides a name lookup 00019 * service. 00020 * 00021 * @author Wei Lin 2012.06.18 00022 * 00023 * @since Coherence 12.1.2 00024 */ 00025 class COH_EXPORT NameService 00026 : public interface_spec<NameService, 00027 implements<Service> > 00028 { 00029 // ----- NameService interface ------------------------------------------ 00030 00031 public: 00032 /** 00033 * Binds a name to an object. 00034 * 00035 * @param vsName the name to bind; may not be empty 00036 * @param o the object to bind; possibly null 00037 */ 00038 virtual void bind(String::View vsName, Object::View o) = 0; 00039 00040 /** 00041 * Retrieves the named object. 00042 * 00043 * @param vsName the name of the object to look up 00044 * 00045 * @return the object bound to sName 00046 * 00047 * @throws NamingException if a naming exception is encountered 00048 */ 00049 virtual Object::View lookup(String::View vsName) = 0; 00050 00051 /** 00052 * Unbinds the named object. 00053 * 00054 * @param vsName the name to bind; may not be empty 00055 */ 00056 virtual void unbind(String::View vsName) = 0; 00057 }; 00058 00059 COH_CLOSE_NAMESPACE2 00060 00061 #endif // COH_NAME_SERVICE_HPP