TcaEndpointID.h

Go to the documentation of this file.
00001 /*
00002  * IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING. By
00003  * downloading, copying, installing or using the software you agree to
00004  * this license. If you do not agree to this license, do not download,
00005  * install, copy or use the software.
00006  * 
00007  * University of Waterloo Open Source License
00008  * 
00009  * Copyright (c) 2005 University of Waterloo. All rights reserved. 
00010  * 
00011  * Redistribution and use in source and binary forms, with or without
00012  * modification, are permitted provided that the following conditions are
00013  * met:
00014  * 
00015  *   Redistributions of source code must retain the above copyright
00016  *   notice, this list of conditions and the following disclaimer.
00017  * 
00018  *   Redistributions in binary form must reproduce the above copyright
00019  *   notice, this list of conditions and the following disclaimer in the
00020  *   documentation and/or other materials provided with the distribution.
00021  *  
00022  *   Neither the name of the University of Waterloo nor the names of its
00023  *   contributors may be used to endorse or promote products derived from
00024  *   this software without specific prior written permission.
00025  *  
00026  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
00027  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
00028  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
00029  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE UNIVERSITY
00030  * OF WATERLOO OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
00031  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
00032  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
00033  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
00034  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
00035  * TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
00036  * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
00037  */
00038 
00039 #ifndef _TCA_ENDPOINTID_H_
00040 #define _TCA_ENDPOINTID_H_
00041 
00042 
00043 #include <string>
00044 #include "dtn_types.h"
00045 
00046 
00047 // Warning: This is a special version of the TcaEndpointID class for use
00048 // on the client side of the interface. The difference is that the other
00049 // TcaEndpointID class (used in the servlib source tree) is subclassed from
00050 // EndpointID, which isn't available here.  
00051 // The interface is almost identical.
00052 
00053 class TcaEndpointID
00054 {
00055 public:
00056     TcaEndpointID() : valid_(false), host_(""), app_("") { }
00057     TcaEndpointID(const dtn_endpoint_id_t& eid);
00058     TcaEndpointID(const std::string& str);
00059     TcaEndpointID(const std::string& host, const std::string& app);
00060     TcaEndpointID(const TcaEndpointID& eid);
00061 
00062     const std::string& host() const { return host_; }
00063     const std::string& app() const { return app_; }
00064     
00065     const std::string str() const { return "tca://" + host_ + "/" + app_; }
00066     const char* c_str() const { return str().c_str(); }
00067 
00068     void set_host(const std::string& host);
00069     void set_app(const std::string& app);
00070 
00071     const std::string get_hostid() const
00072         { return std::string("tca://") + host_; }
00073 
00074     static inline std::string
00075     build(const std::string& host, const std::string& app)
00076         { return std::string("tca://") + host + "/" + app; }
00077     
00078 protected:
00079     // TcaEndpointID caches host part and app part for easy lookup, but
00080     // always maintains the base class strings as well.
00081     bool valid_;
00082     std::string host_;
00083     std::string app_;
00084     void parse(const std::string& str);
00085     
00086 };
00087 
00088 
00089 
00090 #endif /* _TCA_ENDPOINTID_H_ */

Generated on Fri Dec 22 14:48:01 2006 for DTN Reference Implementation by  doxygen 1.5.1