Source

cappuccino-docs / cappuccino docs / cappuccino.org / learn / documentation / _c_p_bundle_8j_source.html

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">

<!-- Mirrored from cappuccino.org/learn/documentation/_c_p_bundle_8j_source.html by HTTrack Website Copier/3.x [XR&CO'2006], Mon, 20 Sep 2010 02:19:29 GMT -->
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>Cappuccino API: Foundation/CPBundle.j Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.1 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul>
      <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Classes</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
    </ul>
  </div>
  <div class="tabs">
    <ul>
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li><a href="globals.html"><span>File&nbsp;Members</span></a></li>
    </ul>
  </div>
<h1>Foundation/CPBundle.j</h1><a href="_c_p_bundle_8j.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">/*</span>
<a name="l00002"></a>00002 <span class="comment"> * CPBundle.j</span>
<a name="l00003"></a>00003 <span class="comment"> * Foundation</span>
<a name="l00004"></a>00004 <span class="comment"> *</span>
<a name="l00005"></a>00005 <span class="comment"> * Created by Francisco Tolmasky.</span>
<a name="l00006"></a>00006 <span class="comment"> * Copyright 2008, 280 North, Inc.</span>
<a name="l00007"></a>00007 <span class="comment"> *</span>
<a name="l00008"></a>00008 <span class="comment"> * This library is free software; you can redistribute it and/or</span>
<a name="l00009"></a>00009 <span class="comment"> * modify it under the terms of the GNU Lesser General Public</span>
<a name="l00010"></a>00010 <span class="comment"> * License as published by the Free Software Foundation; either</span>
<a name="l00011"></a>00011 <span class="comment"> * version 2.1 of the License, or (at your option) any later version.</span>
<a name="l00012"></a>00012 <span class="comment"> *</span>
<a name="l00013"></a>00013 <span class="comment"> * This library is distributed in the hope that it will be useful,</span>
<a name="l00014"></a>00014 <span class="comment"> * but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00015"></a>00015 <span class="comment"> * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU</span>
<a name="l00016"></a>00016 <span class="comment"> * Lesser General Public License for more details.</span>
<a name="l00017"></a>00017 <span class="comment"> *</span>
<a name="l00018"></a>00018 <span class="comment"> * You should have received a copy of the GNU Lesser General Public</span>
<a name="l00019"></a>00019 <span class="comment"> * License along with this library; if not, write to the Free Software</span>
<a name="l00020"></a>00020 <span class="comment"> * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA</span>
<a name="l00021"></a>00021 <span class="comment"> */</span>
<a name="l00022"></a>00022 
<a name="l00023"></a>00023 @<span class="keyword">import</span> <span class="stringliteral">&quot;CPObject.j&quot;</span>
<a name="l00024"></a>00024 @<span class="keyword">import</span> <span class="stringliteral">&quot;CPDictionary.j&quot;</span>
<a name="l00025"></a>00025 
<a name="l00032"></a><a class="code" href="_c_p_bundle_8j.html#acf1f8fc528aa85c020665fcbe609398b">00032</a> var <a class="code" href="_c_p_bundle_8j.html#acf1f8fc528aa85c020665fcbe609398b">CPBundlesForURLStrings</a> = { };
<a name="l00033"></a>00033 
<a name="l00034"></a>00034 <span class="keyword">@implementation </span><a class="code" href="class_c_p_bundle.html" title="Groups information about an application&amp;#39;s code &amp;amp; resources.">CPBundle</a> : <a class="code" href="class_c_p_object.html" title="The root class from which most classes are subclassed.">CPObject</a>
<a name="l00035"></a>00035 {
<a name="l00036"></a>00036     CFBundle    _bundle;
<a name="l00037"></a>00037     <span class="keywordtype">id</span>          _delegate;
<a name="l00038"></a>00038 }
<a name="l00039"></a>00039 
<a name="l00040"></a><a class="code" href="class_c_p_bundle.html#ac049c2056a83d28cff103b794faf56df">00040</a> + (<a class="code" href="class_c_p_bundle.html" title="Groups information about an application&amp;#39;s code &amp;amp; resources.">CPBundle</a>)bundleWithURL:(<a class="code" href="class_c_p_u_r_l.html">CPURL</a>)aURL
<a name="l00041"></a>00041 {
<a name="l00042"></a>00042     <span class="keywordflow">return</span> [[<span class="keyword">self</span> alloc] initWithURL:aURL];
<a name="l00043"></a>00043 }
<a name="l00044"></a>00044 
<a name="l00045"></a><a class="code" href="class_c_p_bundle.html#a62633c48c588429ca66ccceb07e8af1b">00045</a> + (<a class="code" href="class_c_p_bundle.html" title="Groups information about an application&amp;#39;s code &amp;amp; resources.">CPBundle</a>)bundleWithPath:(<a class="code" href="class_c_p_string.html" title="An immutable string (collection of characters).">CPString</a>)aPath
<a name="l00046"></a>00046 {
<a name="l00047"></a>00047     <span class="keywordflow">return</span> [<span class="keyword">self</span> <a class="code" href="class_c_p_bundle.html#ac049c2056a83d28cff103b794faf56df">bundleWithURL</a>:aPath];
<a name="l00048"></a>00048 }
<a name="l00049"></a>00049 
<a name="l00050"></a><a class="code" href="class_c_p_bundle.html#a6b2401dce4d84d49261126169d966567">00050</a> + (<a class="code" href="class_c_p_bundle.html" title="Groups information about an application&amp;#39;s code &amp;amp; resources.">CPBundle</a>)bundleForClass:(Class)aClass
<a name="l00051"></a>00051 {
<a name="l00052"></a>00052     <span class="keywordflow">return</span> [<span class="keyword">self</span> <a class="code" href="class_c_p_bundle.html#ac049c2056a83d28cff103b794faf56df">bundleWithURL</a>:CFBundle.bundleForClass(aClass).bundleURL()];
<a name="l00053"></a>00053 }
<a name="l00054"></a>00054 
<a name="l00055"></a><a class="code" href="class_c_p_bundle.html#a2f1b74bb845caded5d4d8a1309c7ff0e">00055</a> + (<a class="code" href="class_c_p_bundle.html" title="Groups information about an application&amp;#39;s code &amp;amp; resources.">CPBundle</a>)mainBundle
<a name="l00056"></a>00056 {
<a name="l00057"></a>00057     <span class="keywordflow">return</span> [<a class="code" href="class_c_p_bundle.html" title="Groups information about an application&amp;#39;s code &amp;amp; resources.">CPBundle</a> <a class="code" href="class_c_p_bundle.html#a62633c48c588429ca66ccceb07e8af1b">bundleWithPath</a>:CFBundle.mainBundle().bundleURL()];
<a name="l00058"></a>00058 }
<a name="l00059"></a>00059 
<a name="l00060"></a><a class="code" href="class_c_p_bundle.html#a7e6f769b21dd1e3777cffad8ddeb0ad4">00060</a> - (id)initWithURL:(<a class="code" href="class_c_p_u_r_l.html">CPURL</a>)aURL
<a name="l00061"></a>00061 {
<a name="l00062"></a>00062     aURL = <span class="keyword">new</span> CFURL(aURL);
<a name="l00063"></a>00063 
<a name="l00064"></a>00064     var URLString = aURL.<a class="code" href="class_c_p_u_r_l.html#ad2ccd2a9c907f4376793a04cc9c6562d">absoluteString</a>(),
<a name="l00065"></a>00065         existingBundle = <a class="code" href="_c_p_bundle_8j.html#acf1f8fc528aa85c020665fcbe609398b">CPBundlesForURLStrings</a>[URLString];
<a name="l00066"></a>00066 
<a name="l00067"></a>00067     <span class="keywordflow">if</span> (existingBundle)
<a name="l00068"></a>00068         <span class="keywordflow">return</span> existingBundle;
<a name="l00069"></a>00069 
<a name="l00070"></a>00070     <span class="keyword">self</span> = [<span class="keyword">super</span> init];
<a name="l00071"></a>00071 
<a name="l00072"></a>00072     <span class="keywordflow">if</span> (<span class="keyword">self</span>)
<a name="l00073"></a>00073     {
<a name="l00074"></a>00074         _bundle = <span class="keyword">new</span> CFBundle(aURL);
<a name="l00075"></a>00075         <a class="code" href="_c_p_bundle_8j.html#acf1f8fc528aa85c020665fcbe609398b">CPBundlesForURLStrings</a>[URLString] = <span class="keyword">self</span>;
<a name="l00076"></a>00076     }
<a name="l00077"></a>00077 
<a name="l00078"></a>00078     <span class="keywordflow">return</span> <span class="keyword">self</span>;
<a name="l00079"></a>00079 }
<a name="l00080"></a>00080 
<a name="l00081"></a><a class="code" href="class_c_p_bundle.html#a66c2679addf3045e9d3679cf802801e0">00081</a> - (id)initWithPath:(<a class="code" href="class_c_p_string.html" title="An immutable string (collection of characters).">CPString</a>)aPath
<a name="l00082"></a>00082 {
<a name="l00083"></a>00083     <span class="keywordflow">return</span> [<span class="keyword">self</span> <a class="code" href="class_c_p_bundle.html#a7e6f769b21dd1e3777cffad8ddeb0ad4">initWithURL</a>:aPath];
<a name="l00084"></a>00084 }
<a name="l00085"></a>00085 
<a name="l00086"></a><a class="code" href="class_c_p_bundle.html#aeea27ecd16b7db62a0cbf9ccb0bd7cd8">00086</a> - (Class)classNamed:(<a class="code" href="class_c_p_string.html" title="An immutable string (collection of characters).">CPString</a>)aString
<a name="l00087"></a>00087 {
<a name="l00088"></a>00088     <span class="comment">// ???</span>
<a name="l00089"></a>00089 }
<a name="l00090"></a>00090 
<a name="l00091"></a><a class="code" href="class_c_p_bundle.html#a26a9bfb47689468f1bbeb4d9fa0ee28e">00091</a> - (<a class="code" href="class_c_p_u_r_l.html">CPURL</a>)bundleURL
<a name="l00092"></a>00092 {
<a name="l00093"></a>00093     <span class="keywordflow">return</span> _bundle.<a class="code" href="class_c_p_bundle.html#a26a9bfb47689468f1bbeb4d9fa0ee28e">bundleURL</a>();
<a name="l00094"></a>00094 }
<a name="l00095"></a>00095 
<a name="l00096"></a><a class="code" href="class_c_p_bundle.html#a78c1257ffa66279298ffddc7b0c43600">00096</a> - (<a class="code" href="class_c_p_string.html" title="An immutable string (collection of characters).">CPString</a>)bundlePath
<a name="l00097"></a>00097 {
<a name="l00098"></a>00098     <span class="keywordflow">return</span> [[<span class="keyword">self</span> <a class="code" href="class_c_p_bundle.html#a26a9bfb47689468f1bbeb4d9fa0ee28e">bundleURL</a>] <a class="code" href="class_c_p_u_r_l.html#a33b850e8c07c857babcfaae95fd251fd">path</a>];
<a name="l00099"></a>00099 }
<a name="l00100"></a>00100 
<a name="l00101"></a><a class="code" href="class_c_p_bundle.html#a8146bc89e2720a035ff21be1b7d8551e">00101</a> - (<a class="code" href="class_c_p_string.html" title="An immutable string (collection of characters).">CPString</a>)resourcePath
<a name="l00102"></a>00102 {
<a name="l00103"></a>00103     <span class="keywordflow">return</span> [[<span class="keyword">self</span> <a class="code" href="class_c_p_bundle.html#a2572e193706d1f1ebadf393699e3dfc1">resourceURL</a>] <a class="code" href="class_c_p_u_r_l.html#a33b850e8c07c857babcfaae95fd251fd">path</a>];
<a name="l00104"></a>00104 }
<a name="l00105"></a>00105 
<a name="l00106"></a><a class="code" href="class_c_p_bundle.html#a2572e193706d1f1ebadf393699e3dfc1">00106</a> - (<a class="code" href="class_c_p_u_r_l.html">CPURL</a>)resourceURL
<a name="l00107"></a>00107 {
<a name="l00108"></a>00108     <span class="keywordflow">return</span> _bundle.resourcesDirectoryURL();
<a name="l00109"></a>00109 }
<a name="l00110"></a>00110 
<a name="l00111"></a><a class="code" href="class_c_p_bundle.html#ace2371648b67a3465bfd07951906342b">00111</a> - (Class)principalClass
<a name="l00112"></a>00112 {
<a name="l00113"></a>00113     var className = [<span class="keyword">self</span> <a class="code" href="class_c_p_bundle.html#ac6c5a6f04de1fbb5d99c08f689e1ae6e">objectForInfoDictionaryKey</a>:@&quot;CPPrincipalClass&quot;];
<a name="l00114"></a>00114 
<a name="l00115"></a>00115     <span class="comment">//[self load];</span>
<a name="l00116"></a>00116 
<a name="l00117"></a>00117     <span class="keywordflow">return</span> className ? <a class="code" href="_c_p_obj_j_runtime_8j.html#a85b5b743b1775c463208227a3b9238dc">CPClassFromString</a>(className) : Nil;
<a name="l00118"></a>00118 }
<a name="l00119"></a>00119 
<a name="l00120"></a><a class="code" href="class_c_p_bundle.html#a09f6fb5fbe8e49ca2577b82af1c3ffa2">00120</a> - (<a class="code" href="class_c_p_string.html" title="An immutable string (collection of characters).">CPString</a>)pathForResource:(<a class="code" href="class_c_p_string.html" title="An immutable string (collection of characters).">CPString</a>)aFilename
<a name="l00121"></a>00121 {
<a name="l00122"></a>00122     <span class="keywordflow">return</span> _bundle.pathForResource(aFilename);
<a name="l00123"></a>00123 }
<a name="l00124"></a>00124 
<a name="l00125"></a><a class="code" href="class_c_p_bundle.html#a7eeee327b653d8e0b1b67e1236d83227">00125</a> - (<a class="code" href="class_c_p_dictionary.html" title="A mutable key-value pair collection.">CPDictionary</a>)infoDictionary
<a name="l00126"></a>00126 {
<a name="l00127"></a>00127     <span class="keywordflow">return</span> _bundle.<a class="code" href="class_c_p_bundle.html#a7eeee327b653d8e0b1b67e1236d83227">infoDictionary</a>();
<a name="l00128"></a>00128 }
<a name="l00129"></a>00129 
<a name="l00130"></a><a class="code" href="class_c_p_bundle.html#ac6c5a6f04de1fbb5d99c08f689e1ae6e">00130</a> - (id)objectForInfoDictionaryKey:(<a class="code" href="class_c_p_string.html" title="An immutable string (collection of characters).">CPString</a>)aKey
<a name="l00131"></a>00131 {
<a name="l00132"></a>00132     <span class="keywordflow">return</span> _bundle.valueForInfoDictionaryKey(aKey);
<a name="l00133"></a>00133 }
<a name="l00134"></a>00134 
<a name="l00135"></a>00135 <span class="comment">//</span>
<a name="l00136"></a>00136 
<a name="l00137"></a><a class="code" href="class_c_p_bundle.html#a3b4ca32b09ae69fb5cf8924dab4c8e80">00137</a> - (void)loadWithDelegate:(<span class="keywordtype">id</span>)aDelegate
<a name="l00138"></a>00138 {
<a name="l00139"></a>00139     _delegate = aDelegate;
<a name="l00140"></a>00140 
<a name="l00141"></a>00141     _bundle.addEventListener(<span class="stringliteral">&quot;load&quot;</span>, function()
<a name="l00142"></a>00142     {
<a name="l00143"></a>00143         [_delegate bundleDidFinishLoading:self];
<a name="l00144"></a>00144     });
<a name="l00145"></a>00145 
<a name="l00146"></a>00146     _bundle.addEventListener(<span class="stringliteral">&quot;error&quot;</span>, function()
<a name="l00147"></a>00147     {
<a name="l00148"></a>00148         CPLog.error(<span class="stringliteral">&quot;Could not find bundle: &quot;</span> + <span class="keyword">self</span>);
<a name="l00149"></a>00149     });
<a name="l00150"></a>00150 
<a name="l00151"></a>00151     _bundle.load(YES);
<a name="l00152"></a>00152 }
<a name="l00153"></a>00153 
<a name="l00154"></a><a class="code" href="class_c_p_bundle.html#afa868763f81793fd639b2e404cee41ca">00154</a> - (<a class="code" href="class_c_p_array.html" title="A mutable array backed by a JavaScript Array.A mutable array class backed by a JavaScript...">CPArray</a>)staticResourceURLs
<a name="l00155"></a>00155 {
<a name="l00156"></a>00156     var staticResourceURLs = [],
<a name="l00157"></a>00157         staticResources = _bundle.staticResources(),
<a name="l00158"></a>00158         index = 0,
<a name="l00159"></a>00159         count = [staticResources count];
<a name="l00160"></a>00160 
<a name="l00161"></a>00161     <span class="keywordflow">for</span> (; index &lt; count; ++index)
<a name="l00162"></a>00162         [staticResourceURLs addObject:staticResources[index].URL()];
<a name="l00163"></a>00163 
<a name="l00164"></a>00164     <span class="keywordflow">return</span> staticResourceURLs;
<a name="l00165"></a>00165 }
<a name="l00166"></a>00166 
<a name="l00167"></a><a class="code" href="class_c_p_bundle.html#af35a229b0b83b6d915451908937699d3">00167</a> - (<a class="code" href="class_c_p_array.html" title="A mutable array backed by a JavaScript Array.A mutable array class backed by a JavaScript...">CPArray</a>)environments
<a name="l00168"></a>00168 {
<a name="l00169"></a>00169     <span class="keywordflow">return</span> _bundle.<a class="code" href="class_c_p_bundle.html#af35a229b0b83b6d915451908937699d3">environments</a>();
<a name="l00170"></a>00170 }
<a name="l00171"></a>00171 
<a name="l00172"></a><a class="code" href="class_c_p_bundle.html#aa111dcf79af54c4fc17839c9c256e4d6">00172</a> - (<a class="code" href="class_c_p_string.html" title="An immutable string (collection of characters).">CPString</a>)mostEligibleEnvironment
<a name="l00173"></a>00173 {
<a name="l00174"></a>00174     <span class="keywordflow">return</span> _bundle.<a class="code" href="class_c_p_bundle.html#aa111dcf79af54c4fc17839c9c256e4d6">mostEligibleEnvironment</a>();
<a name="l00175"></a>00175 }
<a name="l00176"></a>00176 
<a name="l00177"></a><a class="code" href="class_c_p_bundle.html#afff5f142724d4a805174178b3f49f10b">00177</a> - (<a class="code" href="class_c_p_string.html" title="An immutable string (collection of characters).">CPString</a>)description
<a name="l00178"></a>00178 {
<a name="l00179"></a>00179     <span class="keywordflow">return</span> [<span class="keyword">super</span> description] + <span class="stringliteral">&quot;(&quot;</span> + [<span class="keyword">self</span> <a class="code" href="class_c_p_bundle.html#a78c1257ffa66279298ffddc7b0c43600">bundlePath</a>] + <span class="stringliteral">&quot;)&quot;</span>;
<a name="l00180"></a>00180 }
<a name="l00181"></a>00181 
<a name="l00182"></a>00182 <span class="keyword">@end</span>
</pre></div></div>
<hr size="1"/><address style="text-align: right;"><small>Generated on Tue Apr 6 10:32:56 2010 for Cappuccino API by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>

<!-- Mirrored from cappuccino.org/learn/documentation/_c_p_bundle_8j_source.html by HTTrack Website Copier/3.x [XR&CO'2006], Mon, 20 Sep 2010 02:19:29 GMT -->
</html>