HTTP Utilities Library (InetProtUtils) Example

Download

Click on the following link to download the example: ExampleInetProtUtil.zip

Click: browse to view the example code.

Description

This example code demonstrates the usage of utilities provided by the InetProtUtil API. The users should have a prior knowledge of concepts associated with it, such as URLs and URI components.

The central class is CExampleInetProtUtil, which demonstrates the following functionality:

• Creating a URI

• Modifying a URI

• Resolving a URI

• Parsing a URI

• Validating a URI

• Extracting URI components

• Retrieving a filename from a URI

• Adding and removing delimiters from a URI

• Removing whitespace from a URI

• Escape encoding and decoding a URI

Creating a URI

void CExampleInetProtUtil::CreateUri();

Creates a URI with respect to the physical path of a given file.

For example, the physical path of the file:

K:/ws/direct/direct.mmp

gives the following URI file:

///k/ws/direct/direct.mmp

The screen output from this example is:

Modifying a URI

void CExampleInetProtUtil::ModifyUriComponents();

Modifies URI components, which involves:

1. Adding URI components, where it constructs the URI component by component. For example, you can add the following components:

   • scheme: http

   • host: waterlang.org

   • path: main_page.html

   • port: 8080

   to get the complete URI:

   http://waterlang.org:8080/main_page.html

   The screen output from this example is:

   

2. Removing the specific URI component(s) from a constructed URI. For example, the above URI with the port number removed:

   http://waterlang.org/main_page.html

   The screen output from this example is:

   

Resolving a URI

void CExampleInetProtUtil::ResolveUri();

Resolves the URI, which involves creation of an absolute CUri object from a given reference URI.

The screen output from this example is:

Parsing a URI

void CExampleInetProtUtil::ParseUri();

Parses the URI into its components (as given in RFC2396). The five URI components are:

• scheme

• authority

• path

• query

• fragment.

The screen output from this example is:

Validating a URI

void CExampleInetProtUtil::ValidateUriComponents();

Validates a given URI. This function is usually used for URIs with SIP as the scheme.

The screen output from this example is:

Extracting URI components

void CExampleInetProtUtil::ExtractUriComponents();

Extracts URI components from the given URI.

The screen output from this example is:

Retrieving a filename from a URI

void CExampleInetProtUtil::RetrieveFileName();

Extracts the actual physical location of the file from its URI.

The screen output from this example is:

Adding and removing delimiters from a URI

void CExampleInetProtUtil::ModifyDelimiter();

Adds the delimiters to and removes the delimiters from a URI. Before doing this ensure that:

• the delimiter is set using SetDelimiter()

• the URI has already been parsed.

The screen output from this example is:

Removing whitespace from a URI

void CExampleInetProtUtil::WhiteSpaceRemover();

Removes the whitespace from the given URI and returns the number of white spaces that were removed.

The screen output from this example is:

Escape encoding and decoding a URI

void CExampleInetProtUtil::EscapeEncodeDecode();

Escape encodes the characters in a given URI as escape triplets and decodes it to the original one.

The screen output from this example is:

Class Summary

CUri8

TUriParser8

EscapeUtils

TDelimitedParserBase8

InetProtTextUtils