A brief file description. More...

#include "Arena.h"
#include "HdrToken.h"
#include "HdrHeap.h"
#include "INK_MD5.h"
#include "MMH.h"
#include "MIME.h"
#include "ink_apidefs.h"

Include dependency graph for URL.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	URLImpl
class	URLHashContext
	Crypto Hash context for URLs. More...
class	URL
Enumerations
enum	URLType { URL_TYPE_NONE, URL_TYPE_HTTP, URL_TYPE_HTTPS }
Functions
void	url_adjust (MarshalXlate *str_xlate, int num_xlate)
void	url_init ()
URLImpl *	url_create (HdrHeap *heap)
void	url_clear (URLImpl *url_impl)
void	url_nuke_proxy_stuff (URLImpl *d_url)
URLImpl *	url_copy (URLImpl s_url, HdrHeap s_heap, HdrHeap *d_heap, bool inherit_strs=true)
void	url_copy_onto (URLImpl s_url, HdrHeap s_heap, URLImpl d_url, HdrHeap d_heap, bool inherit_strs=true)
void	url_copy_onto_as_server_url (URLImpl s_url, HdrHeap s_heap, URLImpl d_url, HdrHeap d_heap, bool inherit_strs=true)
	This routine is like url_copy_onto, but clears the scheme/host/user/pass/port components, resulting in a server-style URL.
int	url_print (URLImpl u, char buf, int bufsize, int bufindex, int dumpoffset)
void	url_describe (HdrHeapObjImpl *raw, bool recurse)
int	url_length_get (URLImpl *url)
char *	url_string_get (URLImpl url, Arena arena, int length, HdrHeap heap)
void	url_clear_string_ref (URLImpl *url)
char *	url_string_get_ref (HdrHeap heap, URLImpl url, int *length)
void	url_called_set (URLImpl *url)
char *	url_string_get_buf (URLImpl url, char dstbuf, int dstbuf_size, int *length)
const char *	url_scheme_get (URLImpl url, int length)
void	url_MD5_get (URLImpl url, CryptoHash md5)
void	url_host_MD5_get (URLImpl url, CryptoHash md5)
const char *	url_scheme_set (HdrHeap heap, URLImpl url, const char *value, int value_wks_idx, int length, bool copy_string)
void	url_user_set (HdrHeap heap, URLImpl url, const char *value, int length, bool copy_string)
void	url_password_set (HdrHeap heap, URLImpl url, const char *value, int length, bool copy_string)
void	url_host_set (HdrHeap heap, URLImpl url, const char *value, int length, bool copy_string)
void	url_port_set (HdrHeap heap, URLImpl url, unsigned int port)
void	url_path_set (HdrHeap heap, URLImpl url, const char *value, int length, bool copy_string)
void	url_type_set (URLImpl *url, unsigned int type)
void	url_params_set (HdrHeap heap, URLImpl url, const char *value, int length, bool copy_string)
void	url_query_set (HdrHeap heap, URLImpl url, const char *value, int length, bool copy_string)
void	url_fragment_set (HdrHeap heap, URLImpl url, const char *value, int length, bool copy_string)
MIMEParseResult	url_parse (HdrHeap heap, URLImpl url, const char *start, const char end, bool copy_strings)
MIMEParseResult	url_parse_no_path_component_breakdown (HdrHeap heap, URLImpl url, const char *start, const char end, bool copy_strings)
MIMEParseResult	url_parse_internet (HdrHeap heap, URLImpl url, const char *start, const char end, bool copy_strings)
	Parse internet URL.
MIMEParseResult	url_parse_http (HdrHeap heap, URLImpl url, const char *start, const char end, bool copy_strings)
MIMEParseResult	url_parse_http_no_path_component_breakdown (HdrHeap heap, URLImpl url, const char *start, const char end, bool copy_strings)
char *	url_unescapify (Arena arena, const char str, int length)
void	unescape_str (char &buf, char buf_e, const char &str, const char str_e, int &state)
void	unescape_str_tolower (char &buf, char end, const char &str, const char str_e, int &state)
int	url_canonicalize_port (int type, int port)
Variables
const char *	URL_SCHEME_FILE
const char *	URL_SCHEME_FTP
const char *	URL_SCHEME_GOPHER
const char *	URL_SCHEME_HTTP
const char *	URL_SCHEME_HTTPS
const char *	URL_SCHEME_WS
const char *	URL_SCHEME_WSS
const char *	URL_SCHEME_MAILTO
const char *	URL_SCHEME_NEWS
const char *	URL_SCHEME_NNTP
const char *	URL_SCHEME_PROSPERO
const char *	URL_SCHEME_TELNET
const char *	URL_SCHEME_TUNNEL
const char *	URL_SCHEME_WAIS
const char *	URL_SCHEME_PNM
const char *	URL_SCHEME_RTSP
const char *	URL_SCHEME_RTSPU
const char *	URL_SCHEME_MMS
const char *	URL_SCHEME_MMSU
const char *	URL_SCHEME_MMST
int	URL_WKSIDX_FILE
int	URL_WKSIDX_FTP
int	URL_WKSIDX_GOPHER
int	URL_WKSIDX_HTTP
int	URL_WKSIDX_HTTPS
int	URL_WKSIDX_WS
int	URL_WKSIDX_WSS
int	URL_WKSIDX_MAILTO
int	URL_WKSIDX_NEWS
int	URL_WKSIDX_NNTP
int	URL_WKSIDX_PROSPERO
int	URL_WKSIDX_TELNET
int	URL_WKSIDX_TUNNEL
int	URL_WKSIDX_WAIS
int	URL_WKSIDX_PNM
int	URL_WKSIDX_RTSP
int	URL_WKSIDX_RTSPU
int	URL_WKSIDX_MMS
int	URL_WKSIDX_MMSU
int	URL_WKSIDX_MMST
int	URL_LEN_FILE
int	URL_LEN_FTP
int	URL_LEN_GOPHER
int	URL_LEN_HTTP
int	URL_LEN_HTTPS
int	URL_LEN_WS
int	URL_LEN_WSS
int	URL_LEN_MAILTO
int	URL_LEN_NEWS
int	URL_LEN_NNTP
int	URL_LEN_PROSPERO
int	URL_LEN_TELNET
int	URL_LEN_TUNNEL
int	URL_LEN_WAIS
int	URL_LEN_PNM
int	URL_LEN_RTSP
int	URL_LEN_RTSPU
int	URL_LEN_MMS
int	URL_LEN_MMSU
int	URL_LEN_MMST

Detailed Description

A brief file description.

License

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you 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.

Definition in file URL.h.

Enumeration Type Documentation

enum URLType

Enumerator:

URL_TYPE_NONE
URL_TYPE_HTTP
URL_TYPE_HTTPS

Definition at line 36 of file URL.h.

Function Documentation

void unescape_str	(	char *&	buf,
		char *	buf_e,
		const char *&	str,
		const char *	str_e,
		int &	state
	)

Definition at line 945 of file URL.cc.

References ink_memcpy_until_char(), ParseRules::ink_toupper(), ParseRules::is_alpha(), and ParseRules::is_hex().

Referenced by TSStringPercentDecode(), url_MD5_get_general(), and url_unescapify().

void unescape_str_tolower	(	char *&	buf,
		char *	end,
		const char *&	str,
		const char *	str_e,
		int &	state
	)

Definition at line 1015 of file URL.cc.

References ParseRules::ink_tolower(), ParseRules::ink_toupper(), ParseRules::is_alpha(), and ParseRules::is_hex().

Referenced by url_MD5_get_general().

void url_adjust	(	MarshalXlate *	str_xlate,
		int	num_xlate
	)

void url_called_set ( URLImpl * url )

Definition at line 587 of file URL.cc.

References URLImpl::m_clean, and URLImpl::m_ptr_printed_string.

Referenced by url_fragment_set(), url_host_set(), url_params_set(), url_password_set(), url_path_set(), url_port_set(), url_query_set(), url_scheme_set(), url_type_set(), and url_user_set().

int url_canonicalize_port	(	int	type,
		int	port
	)			`[inline]`

Definition at line 246 of file URL.h.

References URL_TYPE_HTTP, and URL_TYPE_HTTPS.

Referenced by HTTPHdr::_fill_target_cache(), HttpTransact::build_request(), how_to_open_connection(), URL::port_get(), url_host_MD5_get(), url_MD5_get_fast(), and url_MD5_get_general().

void url_clear ( URLImpl * url_impl )

Definition at line 242 of file URL.cc.

References obj_clear_data().

Referenced by http_hdr_copy_onto(), PrefetchBlaster::init(), TSUrlParse(), and HTTPHdr::url_set().

void url_clear_string_ref ( URLImpl * url )

Definition at line 593 of file URL.cc.

References URLImpl::m_clean, URLImpl::m_len_printed_string, and URLImpl::m_ptr_printed_string.

Referenced by URL::clear_string_ref(), url_copy_onto_as_server_url(), and url_create().

URLImpl* url_copy	(	URLImpl *	s_url,
		HdrHeap *	s_heap,
		HdrHeap *	d_heap,
		bool	inherit_strs = `true`
	)

Definition at line 253 of file URL.cc.

References url_copy_onto(), and url_create().

Referenced by TSUrlClone().

void url_copy_onto	(	URLImpl *	s_url,
		HdrHeap *	s_heap,
		URLImpl *	d_url,
		HdrHeap *	d_heap,
		bool	inherit_strs = `true`
	)

Definition at line 264 of file URL.cc.

References HdrHeap::inherit_string_heaps(), and obj_copy_data().

Referenced by URL::copy(), http_hdr_copy_onto(), TSUrlCopy(), url_copy(), and HTTPHdr::url_set().

void url_copy_onto_as_server_url	(	URLImpl *	s_url,
		HdrHeap *	s_heap,
		URLImpl *	d_url,
		HdrHeap *	d_heap,
		bool	inherit_strs = `true`
	)

This routine is like url_copy_onto, but clears the scheme/host/user/pass/port components, resulting in a server-style URL.

Definition at line 304 of file URL.cc.

References HdrHeap::inherit_string_heaps(), URLImpl::m_len_fragment, URLImpl::m_len_params, URLImpl::m_len_path, URLImpl::m_len_query, URLImpl::m_ptr_fragment, URLImpl::m_ptr_params, URLImpl::m_ptr_path, URLImpl::m_ptr_query, URLImpl::m_type_code, URLImpl::m_url_type, url_clear_string_ref(), and url_nuke_proxy_stuff().

Referenced by HTTPHdr::url_set_as_server_url().

URLImpl* url_create ( HdrHeap * heap )

Definition at line 226 of file URL.cc.

References HdrHeap::allocate_obj(), HDR_HEAP_OBJ_URL, obj_clear_data(), and url_clear_string_ref().

Referenced by URL::create(), HdrHeap_Coalesce(), http_hdr_copy_onto(), http_hdr_init(), TSHttpHdrTypeSet(), TSUrlCreate(), and url_copy().

void url_describe	(	HdrHeapObjImpl *	raw,
		bool	recurse
	)

void url_fragment_set	(	HdrHeap *	heap,
		URLImpl *	url,
		const char *	value,
		int	length,
		bool	copy_string
	)

Definition at line 558 of file URL.cc.

References URLImpl::m_len_fragment, URLImpl::m_ptr_fragment, mime_str_u16_set(), and url_called_set().

Referenced by URL::fragment_set(), and url_parse_http().

void url_host_MD5_get	(	URLImpl *	url,
		CryptoHash *	md5
	)

Definition at line 1738 of file URL.cc.

References MD5Context::finalize(), URLImpl::m_len_host, URLImpl::m_len_scheme, URLImpl::m_port, URLImpl::m_ptr_host, URLImpl::m_ptr_scheme, URLImpl::m_url_type, MD5Context::update(), and url_canonicalize_port().

Referenced by URL::host_hash_get().

void url_host_set	(	HdrHeap *	heap,
		URLImpl *	url,
		const char *	value,
		int	length,
		bool	copy_string
	)

Definition at line 474 of file URL.cc.

References URLImpl::m_len_host, URLImpl::m_ptr_host, mime_str_u16_set(), and url_called_set().

Referenced by URL::host_set(), url_parse_http_no_path_component_breakdown(), and url_parse_internet().

void url_init ( )

Definition at line 116 of file URL.cc.

References hdrtoken_init(), hdrtoken_string_to_wks(), hdrtoken_wks_to_index(), hdrtoken_wks_to_length(), ink_assert, URLHashContext::OBJ_SIZE, URL_LEN_FILE, URL_LEN_FTP, URL_LEN_GOPHER, URL_LEN_HTTP, URL_LEN_HTTPS, URL_LEN_MAILTO, URL_LEN_MMS, URL_LEN_MMST, URL_LEN_MMSU, URL_LEN_NEWS, URL_LEN_NNTP, URL_LEN_PNM, URL_LEN_PROSPERO, URL_LEN_RTSP, URL_LEN_RTSPU, URL_LEN_TELNET, URL_LEN_TUNNEL, URL_LEN_WAIS, URL_LEN_WS, URL_LEN_WSS, URL_SCHEME_FILE, URL_SCHEME_FTP, URL_SCHEME_GOPHER, URL_SCHEME_HTTP, URL_SCHEME_HTTPS, URL_SCHEME_MAILTO, URL_SCHEME_MMS, URL_SCHEME_MMST, URL_SCHEME_MMSU, URL_SCHEME_NEWS, URL_SCHEME_NNTP, URL_SCHEME_PNM, URL_SCHEME_PROSPERO, URL_SCHEME_RTSP, URL_SCHEME_RTSPU, URL_SCHEME_TELNET, URL_SCHEME_TUNNEL, URL_SCHEME_WAIS, URL_SCHEME_WS, URL_SCHEME_WSS, URL_WKSIDX_FILE, URL_WKSIDX_FTP, URL_WKSIDX_GOPHER, URL_WKSIDX_HTTP, URL_WKSIDX_HTTPS, URL_WKSIDX_MAILTO, URL_WKSIDX_MMS, URL_WKSIDX_MMST, URL_WKSIDX_MMSU, URL_WKSIDX_NEWS, URL_WKSIDX_NNTP, URL_WKSIDX_PNM, URL_WKSIDX_PROSPERO, URL_WKSIDX_RTSP, URL_WKSIDX_RTSPU, URL_WKSIDX_TELNET, URL_WKSIDX_TUNNEL, URL_WKSIDX_WAIS, URL_WKSIDX_WS, and URL_WKSIDX_WSS.

Referenced by HdrTest::go(), http_init(), and init_http_header().

int url_length_get ( URLImpl * url )

void url_MD5_get	(	URLImpl *	url,
		CryptoHash *	md5
	)

Definition at line 1709 of file URL.cc.

References BUFSIZE, ink_assert, URLImpl::m_len_host, URLImpl::m_len_params, URLImpl::m_len_password, URLImpl::m_len_path, URLImpl::m_len_query, URLImpl::m_len_scheme, URLImpl::m_len_user, URLImpl::m_ptr_host, URLImpl::m_ptr_path, URLImpl::m_url_type, url_hash_method, url_MD5_get_fast(), url_MD5_get_general(), and URL_TYPE_HTTP.

Referenced by URL::hash_get(), and TSCacheKeyDigestFromUrlSet().

void url_nuke_proxy_stuff ( URLImpl * d_url )

Definition at line 277 of file URL.cc.

References URLImpl::m_len_host, URLImpl::m_len_password, URLImpl::m_len_port, URLImpl::m_len_scheme, URLImpl::m_len_user, URLImpl::m_port, URLImpl::m_ptr_host, URLImpl::m_ptr_password, URLImpl::m_ptr_port, URLImpl::m_ptr_scheme, URLImpl::m_ptr_user, and URLImpl::m_scheme_wks_idx.

Referenced by URL::nuke_proxy_stuff(), HttpSM::redirect_request(), and url_copy_onto_as_server_url().

void url_params_set	(	HdrHeap *	heap,
		URLImpl *	url,
		const char *	value,
		int	length,
		bool	copy_string
	)

Definition at line 538 of file URL.cc.

References URLImpl::m_len_params, URLImpl::m_ptr_params, mime_str_u16_set(), and url_called_set().

Referenced by URL::params_set(), and url_parse_http().

MIMEParseResult url_parse	(	HdrHeap *	heap,
		URLImpl *	url,
		const char **	start,
		const char *	end,
		bool	copy_strings
	)

Definition at line 1152 of file URL.cc.

References PARSE_CONT, url_parse_http(), and url_parse_scheme().

Referenced by http_parser_parse_req(), URL::parse(), and HTTPHdr::url_set().

MIMEParseResult url_parse_http	(	HdrHeap *	heap,
		URLImpl *	url,
		const char **	start,
		const char *	end,
		bool	copy_strings
	)

Definition at line 1305 of file URL.cc.

References GETNEXT, ink_assert, url_fragment_set(), url_params_set(), url_parse_internet(), url_path_set(), and url_query_set().

Referenced by url_parse().

MIMEParseResult url_parse_http_no_path_component_breakdown	(	HdrHeap *	heap,
		URLImpl *	url,
		const char **	start,
		const char *	end,
		bool	copy_strings
	)

Definition at line 1407 of file URL.cc.

References url_host_set(), url_path_set(), and url_port_set().

Referenced by url_parse_no_path_component_breakdown().

MIMEParseResult url_parse_internet	(	HdrHeap *	heap,
		URLImpl *	url,
		char const **	start,
		char const *	end,
		bool	copy_strings_p
	)

Parse internet URL.

  [://][user[:password]@]host[:port]

  some.place/
  some.place:80/
  foo@some.place:80/
  foo:bar@some.place:80/
  foo:bar@some.place/
  foo:42@some.place/

Definition at line 1182 of file URL.cc.

References ts::ConstBuffer::_ptr, ts::ConstBuffer::_size, ink_assert, ts::ConstBuffer::set(), url_host_set(), url_password_set(), url_port_set(), and url_user_set().

Referenced by url_parse_http().