as3corelib Tutorial:How to Use URI in Flex

February 16th, 2009 Ntt.cc
  

penguin-256x256 IMO, the major usage of this class is parsing a URL to retrieve the information such as host, port, file name, file extension, query, etc. It’s really a convenient way instead of using regular expression to parse the target information.

According to the documentation of as3corelib:

  1. This class implements functions and utilities for working with URI’s (Universal Resource Identifiers). For technical description of the URI syntax, please see RFC 3986 at http://www.ietf.org/rfc/rfc3986.txt or do a web search for “RFC 3986″.

The most important aspect of URI’s to understand is that URI’s and URL’s are not strings. URI’s are complex data structures that encapsulate many pieces of information. The string version of a URI is the serialized representation of that data structure. This string serialization is used to provide a human readable representation and a means to transport the data over the network where it can then be parsed back into its’ component parts.

URI’s fall into one of three categories:

  1. <scheme>:<scheme-specific-part>#<fragment> (non-hierarchical)
  2. <scheme>:<authority><path>?<query>#<fragment> (hierarchical)=""></authority><path>?<query>#<fragment>>
  3. <path>?<query>#<fragment> (relative hierarchical)

The query and fragment parts are optional.

This class supports both non-hierarchical and hierarchical URI’s

Search-256x256 Demo | DownloadDownload Full Project

This class is intended to be used “as-is” for the vast majority of common URI’s. However, if your application requires a custom URI syntax (e.g. custom query syntax or special handling of non-hierarchical URI’s), this class can be fully sub-classed. If you intended to subclass URI, please see the source code for complete documentation on protected members and protected functions.

For example:

  1. var uri:URI = new URI(Application.application.url);
  2. userService.url = “http://”+uri.authority+ (uri.port==””?””:”:”+uri.port) + ”/FileManage/servlet”;

Here, the URI class is used to retrieve the host value and port value of the server which reserves the requested flex application.

The documentation of this class is attached at the end of this article.

Screenshot of this demo:

clip_image002

Following is the source code of URIExample.xml

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <uris>
  3.     <uri value="ftp://tom:goodday@ftp.is.co.za:22/"/>
  4.     <uri value="ftp://ftp.is.co.za/rfc/rfc1808.html"/>
  5.     <uri value="http://www.ietf.org/rfc/rfc2396.txt#anchor1"/>
  6.     <uri value="http://www.ietf.org:8080/rfc/rfc2396.txt"/>
  7.     <uri value="http://www.ietf.org:8080/rfc/"/>
  8.     <uri value="http://something.com/a/b/c/"/>
  9.     <uri value="http://www.ietf.org:8080/rfc"/>
  10.     <uri value="www.ietf.org:8080/rfc/rfc2396.txt"/>
  11.     <uri value="/rfc/rfc2396.txt"/>
  12.     <uri value="rfc/background.png"/>
  13.     <uri value="../rfc/rfc2396.txt"/>
  14.     <uri value="file:///F:/opensource/as3corelib-.92.1/as3corelib-.92.1/docs/index.html"/>   
  15.     <uri value="F:/opensource/as3corelib-.92.1/as3corelib-.92.1/docs/index.html"/>   
  16.     <uri value="F:\\opensource\\as3corelib-.92.1\\as3corelib-.92.1\\docs\\index.html"/>   
  17.     <uri value="ldap://[2001:db8::7]/c=GB?objectClass?one"/>
  18.     <uri value="mailto:John.Doe@example.com"/>
  19.     <uri value="news:comp.infosystems.www.servers.unix"/>
  20.     <uri value="tel:+1-816-555-1212"/>
  21.     <uri value="telnet://192.0.2.16:80/"/>
  22.     <uri value="urn:oasis:names:specification:docbook:dtd:xml:4.1.2"/>
  23. </uris>

And the source code of URIDemo.mxml

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute">
  3.     <mx:Script>
  4.         <![CDATA[
  5.             import com.adobe.net.URI;   
  6.                    
  7.             [Bindable]
  8.             private var uri:URI;
  9.            
  10.             private function selectURI(event:MouseEvent):void
  11.             {
  12.                 uri = new URI(event.currentTarget.text);
  13.             }
  14.         ]]>
  15.     </mx:Script>
  16.    
  17.     <mx:XML id="uris" source="URIExample.xml"/>
  18.    
  19.     <mx:Panel 
  20.         layout="horizontal"
  21.         width="100%"
  22.         height="100%"
  23.         title="URI Demo"
  24.         >
  25.         <mx:VBox>
  26.             <mx:Repeater id="uriList" dataProvider="{uris.uri}">
  27.                 <mx:Label
  28.                     text="{uriList.currentItem.@value}"               
  29.                     buttonMode="true"
  30.                     mouseChildren="false"
  31.                     click="selectURI(event);"/>
  32.             </mx:Repeater>
  33.         </mx:VBox>
  34.        
  35.         <mx:Form
  36.             paddingTop="0">
  37.             <mx:FormItem label="is valid">
  38.                 <mx:Label text="{uri.isValid()}"/>
  39.             </mx:FormItem>
  40.            
  41.             <mx:FormItem label="to display string">
  42.                 <mx:Label text="{uri.toDisplayString()}"/>
  43.             </mx:FormItem>
  44.            
  45.             <mx:FormItem label="to string">
  46.                 <mx:Label text="{uri.toString()}"/>
  47.             </mx:FormItem>
  48.            
  49.             <mx:FormItem label="schema">
  50.                 <mx:Label text="{uri.scheme}"/>
  51.             </mx:FormItem>
  52.            
  53.             <mx:FormItem label="username">
  54.                 <mx:Label text="{uri.username}"/>
  55.             </mx:FormItem>
  56.            
  57.             <mx:FormItem label="password">
  58.                 <mx:Label text="{uri.password}"/>
  59.             </mx:FormItem>
  60.            
  61.             <mx:FormItem label="authority">
  62.                 <mx:Label text="{uri.authority}"/>
  63.             </mx:FormItem>
  64.            
  65.             <mx:FormItem label="default port">
  66.                 <mx:Label text="{uri.getDefaultPort()}"/>
  67.             </mx:FormItem>
  68.            
  69.             <mx:FormItem label="port">
  70.                 <mx:Label text="{uri.port}"/>
  71.             </mx:FormItem>
  72.            
  73.             <mx:FormItem label="path">
  74.                 <mx:Label text="{uri.path}"/>
  75.             </mx:FormItem>
  76.            
  77.             <mx:FormItem label="file name">
  78.                 <mx:Label text="{uri.getFilename(true)}"/>
  79.             </mx:FormItem>
  80.            
  81.             <mx:FormItem label="extension">
  82.                 <mx:Label text="{uri.getExtension(true)}"/>
  83.             </mx:FormItem>
  84.            
  85.             <mx:FormItem label="query">
  86.                 <mx:Label text="{uri.query}"/>
  87.             </mx:FormItem>
  88.            
  89.             <mx:FormItem label="queryRaw">
  90.                 <mx:Label text="{uri.queryRaw}"/>
  91.             </mx:FormItem>
  92.            
  93.             <mx:FormItem label="fragment">
  94.                 <mx:Label text="{uri.fragment}"/>
  95.             </mx:FormItem>
  96.            
  97.             <mx:FormItem label="nonHierarchical">
  98.                 <mx:Label text="{uri.nonHierarchical}"/>
  99.             </mx:FormItem>
  100.            
  101.             <mx:FormItem label="is absolute uri">
  102.                 <mx:Label text="{uri.isAbsolute()}"/>
  103.             </mx:FormItem>
  104.            
  105.             <mx:FormItem label="is relative uri">
  106.                 <mx:Label text="{uri.isRelative()}"/>
  107.             </mx:FormItem>
  108.            
  109.             <mx:FormItem label="is directory">
  110.                 <mx:Label text="{uri.isDirectory()}"/>
  111.             </mx:FormItem>
  112.            
  113.             <mx:FormItem label="is hierarchical">
  114.                 <mx:Label text="{uri.isHierarchical()}"/>
  115.             </mx:FormItem>
  116.             <!--
  117.                 it seems isOfFileType return the opposite
  118.                 result. maybe it's a bug of this method.
  119.             -->
  120.             <mx:FormItem label="is of file type(html)">
  121.                 <mx:Label text="{uri.getExtension(true)==''?false:!uri.isOfFileType('html')}"/>
  122.             </mx:FormItem>
  123.         </mx:Form>
  124.        
  125.         <mx:ControlBar>
  126.             <mx:Form>
  127.                 <mx:FormItem label="custom uri">
  128.                     <mx:TextInput id="customURI"/>
  129.                 </mx:FormItem>
  130.                
  131.                 <mx:FormItem>
  132.                     <mx:Button  id="parseButton" 
  133.                         label="parse" 
  134.                         click="uri = new URI(customURI.text)"/>
  135.                 </mx:FormItem>
  136.             </mx:Form>
  137.         </mx:ControlBar>
  138.     </mx:Panel>
  139. </mx:Application>
Share and Enjoy:
  • Digg
  • del.icio.us
  • Facebook
  • Google Bookmarks
  • DZone
  • Reddit
  • Technorati
  • StumbleUpon
  • Twitter
If you enjoyed this post, please consider to leave a comment or subscribe to the feed and get future articles delivered to your feed reader.
Posted in as3Corelib Tags: , , , 6,095 views
RSS Enjoy this Post? Subscribe to Ntt.cc

RSS Feed   RSS Feed     Email Feed  Email Feed Follow us Follow us

You might also want to read...

«
»
You can leave a response, or trackback from your own site.

2 Responses to “as3corelib Tutorial:How to Use URI in Flex”

  1. Steve says:
    August 17, 2009 at 12:03 pm

    Hi There

    Great tutorial. I was wondering if you could point me in the right direction as this tutorial seems to be what i am after – but might be a bit much for the simple feature i am trying to acheive.

    I have a external .swf file which will get loaded by either swfloader or navigateToURL via a flex app. the .swf file is not part of the flex framework, and it has a URI datainput field with a clickable button.

    What i am trying to do is basically move that URI datainput field from the external .swf file and put it in the flex app. When the clickable button is pressed i need a variable with the URI value sent to the .swf, so that when the .swf fires it also looks for and loads the URI variable data.

    Any help guys would be really appreciated, this thing is pulling my hair out.

    Regards

    Steve

    Reply
  2. as3Corelib里的URI | 胖猫的窝 says:
    September 28, 2009 at 3:25 pm

    [...] 原文：http://ntt.cc/2009/02/16/as3corelib-tutorialhow-to-use-uri-class-in-flex.html Tags: AS3, as3Corelib, Flash, Flex You can follow any responses to this entry through the RSS 2.0 feed. You can leave a response, or trackback from your own site. [...]

    Reply

Leave a Reply