7dbd17a5aa
Former-commit-id:133dc97f67[formerlya02aeb236c] [formerly9f19e3f712] [formerly133dc97f67[formerlya02aeb236c] [formerly9f19e3f712] [formerly06a8b51d6d[formerly9f19e3f712[formerly 64fa9254b946eae7e61bbc3f513b7c3696c4f54f]]]] Former-commit-id:06a8b51d6dFormer-commit-id:9bb8decbcf[formerly8e80217e59] [formerly377dcd10b9[formerly3360eb6c5f]] Former-commit-id:377dcd10b9Former-commit-id:e2ecdcfe33
93 lines
3.1 KiB
C++
93 lines
3.1 KiB
C++
#ifndef QPID_URL_H
|
|
#define QPID_URL_H
|
|
|
|
/*
|
|
*
|
|
* Copyright (c) 2006 The Apache Software Foundation
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*
|
|
*/
|
|
|
|
#include "qpid/Address.h"
|
|
#include "qpid/Exception.h"
|
|
#include <string>
|
|
#include <vector>
|
|
#include <new>
|
|
#include <ostream>
|
|
#include "qpid/CommonImportExport.h"
|
|
|
|
namespace qpid {
|
|
|
|
QPID_COMMON_EXTERN std::ostream& operator<<(std::ostream& os, const TcpAddress& a);
|
|
|
|
/** An AMQP URL contains a list of addresses */
|
|
struct Url : public std::vector<Address> {
|
|
|
|
/** Url with the hostname as returned by gethostname(2) */
|
|
static Url getHostNameUrl(uint16_t port);
|
|
|
|
/** Url with local IP address(es), may be more than one address
|
|
* on a multi-homed host. */
|
|
QPID_COMMON_EXTERN static Url getIpAddressesUrl(uint16_t port);
|
|
|
|
struct Invalid : public Exception { Invalid(const std::string& s); };
|
|
|
|
/** Convert to string form. */
|
|
QPID_COMMON_EXTERN std::string str() const;
|
|
|
|
/** Empty URL. */
|
|
Url() {}
|
|
|
|
/** URL containing a single address */
|
|
explicit Url(const Address& addr) { push_back(addr); }
|
|
|
|
/** Parse url, throw Invalid if invalid. */
|
|
explicit Url(const std::string& url) { parse(url.c_str()); }
|
|
|
|
/** Parse url, throw Invalid if invalid. */
|
|
explicit Url(const char* url) { parse(url); }
|
|
|
|
Url& operator=(const Url& u) { this->std::vector<Address>::operator=(u); cache=u.cache; return *this; }
|
|
Url& operator=(const char* s) { parse(s); return *this; }
|
|
Url& operator=(const std::string& s) { parse(s); return *this; }
|
|
|
|
/** Throw Invalid if the URL does not contain any addresses. */
|
|
QPID_COMMON_EXTERN void throwIfEmpty() const;
|
|
|
|
/** Replace contents with parsed URL as defined in
|
|
* https://wiki.108.redhat.com/jira/browse/AMQP-95
|
|
*@exception Invalid if the url is invalid.
|
|
*/
|
|
QPID_COMMON_EXTERN void parse(const char* url);
|
|
QPID_COMMON_EXTERN void parse(const std::string& url) { parse(url.c_str()); }
|
|
|
|
/** Replace contesnts with parsed URL as defined in
|
|
* https://wiki.108.redhat.com/jira/browse/AMQP-95
|
|
* url.empty() will be true if url is invalid.
|
|
*/
|
|
void parseNoThrow(const char* url);
|
|
|
|
private:
|
|
mutable std::string cache; // cache string form for efficiency.
|
|
};
|
|
|
|
inline bool operator==(const Url& a, const Url& b) { return a.str()==b.str(); }
|
|
inline bool operator!=(const Url& a, const Url& b) { return a.str()!=b.str(); }
|
|
|
|
QPID_COMMON_EXTERN std::ostream& operator<<(std::ostream& os, const Url& url);
|
|
QPID_COMMON_EXTERN std::istream& operator>>(std::istream& is, Url& url);
|
|
|
|
} // namespace qpid
|
|
|
|
#endif /*!QPID_URL_H*/
|