Extracting -URI Components

This tutorials describe the steps to extract URI components.

Introduction

URI components can be extracted from -an URI using TUriC8::Extract() and passing a TUriComponent flag. -For example, EUriQuery or EUriPath.

Extracting a scheme component

The following code -fragment illustrates how to extract a scheme component. Parse the URI before -the component is extracted calling TUriParser8::Parse().

-_LIT8( KUri,"http://web.intra/Dev/Sysdoc/devlib.htm" ); -TUriParser8 parser; // URI parser object -TInt result = parser.Parse( KUri ); // parse the URI descriptor - -//Extract the scheme component from the parsed URI -const TDesC8& des = parser.Extract( EUriScheme ); -

where des is a descriptor that contains the -extracted scheme component. Other components such as userinfo, host, port -and so on defined in TUriComponent can be extracted in -a similar way.

Extracting an authority component

To retrieve a -specific authority component from the URI, call TAuthority8::Extract(). -The following code fragment illustrates how to extract a authority component.

-_LIT8( KAuthorityDesc, "http://user:pass@www.mypage.com" ); -TAuthorityParser8 authorityParser; //Authority parser object - -authorityParser.Parse( KAuthorityDesc ); //Parse the authority descriptor -//extract the user infomation from the authority component -const TDesC8& des = authorityParser.Extract( EAuthorityUserinfo ); -

where, des contains the user info that is -extracted from the authority component. EAuthorityUserinfo is -an enum value of TAuthorityComponent. Similarly, host and -port can be extracted using EAuthorityHost and EAuthorityPort respectively, -which are defined in TAuthorityComponent.

Displaying the URI

To create a new descriptor containing -the desired component or the full URI, call TUriC8::DisplayFormL().

This -converts a component into a new descriptor. The component to be converted -can take any value between EUriScheme and EUriFragment or EUriComplete (for -the full URI). This method is used to obtain a pointer to a 16 bit descriptor -for GUI display of URI.

HBufC16* uri = parsedUri->DisplayFormL( EUriComplete );

where EUriComplete indicates that all the components -in the URI are displayed.

To fetch the URI, call TUriC8::UriDes(). -This returns a pointer to 8 bit descriptor(TDesC8) containing -the URI, which is used for HTTP requests.

Displaying authority

To create a new descriptor -containing a specific component or the full authority component, call TAuthority8::DisplayFormL().

This -converts a component into a new descriptor. The component to be converted -can take any value between EAuthorityUserinfo and EAuthorityPort or -the full authority, EAuthorityComplete.

HBufC authority = parsedUri->DisplayFormL( EAuthorityComplete );

where EAuthorityComplete means that the complete authority -is displayed.