Java Doc for JarURLConnection.java in  » 6.0-JDK-Modules » j2me » java » net » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » 6.0 JDK Modules » j2me » java.net 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   java.net.URLConnection
      java.net.JarURLConnection

All known Subclasses:   sun.net.www.protocol.jar.JarURLConnection,
JarURLConnection
abstract public class JarURLConnection extends URLConnection (Code)
A URL Connection to a Java ARchive (JAR) file or an entry in a JAR file.

The syntax of a JAR URL is:

 jar:<url>!/{entry}
 

for example:

jar:http://www.foo.com/bar/baz.jar!/COM/foo/Quux.class

Jar URLs should be used to refer to a JAR file or entries in a JAR file. The example above is a JAR URL which refers to a JAR entry. If the entry name is omitted, the URL refers to the whole JAR file: jar:http://www.foo.com/bar/baz.jar!/

Users should cast the generic URLConnection to a JarURLConnection when they know that the URL they created is a JAR URL, and they need JAR-specific functionality. For example:

 URL url = new URL("jar:file:/home/duke/duke.jar!/");
 JarURLConnection jarConnection = (JarURLConnection)url.openConnection();
 Manifest manifest = jarConnection.getManifest();
 

Examples:

A Jar entry
jar:http://www.foo.com/bar/baz.jar!/COM/foo/Quux.class
A Jar file
jar:http://www.foo.com/bar/baz.jar!/
A Jar directory
jar:http://www.foo.com/bar/baz.jar!/COM/foo/

!/ is refered to as the separator.

When constructing a JAR url via new URL(context, spec), the following rules apply:

  • if there is no context URL and the specification passed to the URL constructor doesn't contain a separator, the URL is considered to refer to a JarFile.
  • if there is a context URL, the context URL is assumed to refer to a JAR file or a Jar directory.
  • if the specification begins with a '/', the Jar directory is ignored, and the spec is considered to be at the root of the Jar file.

    Examples:

    context: jar:http://www.foo.com/bar/jar.jar!/, spec:baz/entry.txt
    url:jar:http://www.foo.com/bar/jar.jar!/baz/entry.txt
    context: jar:http://www.foo.com/bar/jar.jar!/baz, spec:entry.txt
    url:jar:http://www.foo.com/bar/jar.jar!/baz/entry.txt
    context: jar:http://www.foo.com/bar/jar.jar!/baz, spec:/entry.txt
    url:jar:http://www.foo.com/bar/jar.jar!/entry.txt

See Also:   java.net.URL
See Also:   java.net.URLConnection
See Also:   java.util.jar.JarFile
See Also:   java.util.jar.JarInputStream
See Also:   java.util.jar.Manifest
See Also:   java.util.zip.ZipEntry
author:
   Benjamin Renaud
since:
   1.2


Field Summary
protected  URLConnectionjarFileURLConnection
     The connection to the JAR file URL, if the connection has been initiated.

Constructor Summary
protected  JarURLConnection(URL url)
     Creates the new JarURLConnection to the specified URL.
Parameters:
  url - the URL
throws:
  MalformedURLException - if no legal protocol could be found in a specification string or the string could not be parsed.

Method Summary
public  AttributesgetAttributes()
     Return the Attributes object for this connection if the URL for it points to a JAR file entry, null otherwise. the Attributes object for this connection if the URLfor it points to a JAR file entry, null otherwise.
public  java.security.cert.Certificate[]getCertificates()
     Return the Certificate object for this connection if the URL for it points to a JAR file entry, null otherwise.
public  StringgetEntryName()
     Return the entry name for this connection.
public  JarEntrygetJarEntry()
     Return the JAR entry object for this connection, if any.
abstract public  JarFilegetJarFile()
     Return the JAR file for this connection.
public  URLgetJarFileURL()
     Returns the URL for the Jar file for this connection.
public  AttributesgetMainAttributes()
     Returns the main Attributes for the JAR file for this connection.
public  ManifestgetManifest()
     Returns the Manifest for this connection, or null if none.

Field Detail
jarFileURLConnection
protected URLConnection jarFileURLConnection(Code)
The connection to the JAR file URL, if the connection has been initiated. This should be set by connect.




Constructor Detail
JarURLConnection
protected JarURLConnection(URL url) throws MalformedURLException(Code)
Creates the new JarURLConnection to the specified URL.
Parameters:
  url - the URL
throws:
  MalformedURLException - if no legal protocol could be found in a specification string or the string could not be parsed.




Method Detail
getAttributes
public Attributes getAttributes() throws IOException(Code)
Return the Attributes object for this connection if the URL for it points to a JAR file entry, null otherwise. the Attributes object for this connection if the URLfor it points to a JAR file entry, null otherwise.
exception:
  IOException - if getting the JAR entry causes anIOException to be thrown.
See Also:   JarURLConnection.getJarEntry



getCertificates
public java.security.cert.Certificate[] getCertificates() throws IOException(Code)
Return the Certificate object for this connection if the URL for it points to a JAR file entry, null otherwise. This method can only be called once the connection has been completely verified by reading from the input stream until the end of the stream has been reached. Otherwise, this method will return null

NOTE: In J2ME CDC, there is no support for certificates by design. If CDC by itself or a J2ME profile built on CDC does not add back the java.security.Signature class (plus all its dependencies), a null value must always be returned. the Certificate object for this connection if the URLfor it points to a JAR file entry, null otherwise.
exception:
  IOException - if getting the JAR entry causes anIOException to be thrown.
See Also:   JarURLConnection.getJarEntry




getEntryName
public String getEntryName()(Code)
Return the entry name for this connection. This method returns null if the JAR file URL corresponding to this connection points to a JAR file and not a JAR file entry. the entry name for this connection, if any.



getJarEntry
public JarEntry getJarEntry() throws IOException(Code)
Return the JAR entry object for this connection, if any. This method returns null if the JAR file URL corresponding to this connection points to a JAR file and not a JAR file entry. The returned object is not modifiable, and will throw UnsupportedOperationException if the caller attempts to modify it. the JAR entry object for this connection, or null ifthe JAR URL for this connection points to a JAR file.
exception:
  IOException - if getting the JAR file for thisconnection causes an IOException to be trown.
See Also:   JarURLConnection.getJarFile
See Also:   JarURLConnection.getJarEntry



getJarFile
abstract public JarFile getJarFile() throws IOException(Code)
Return the JAR file for this connection. The returned object is not modifiable, and will throw UnsupportedOperationException if the caller attempts to modify it. the JAR file for this connection. If the connection isa connection to an entry of a JAR file, the JAR file object isreturned
exception:
  IOException - if an IOException occurs while trying toconnect to the JAR file for this connection.
See Also:   JarURLConnection.connect



getJarFileURL
public URL getJarFileURL()(Code)
Returns the URL for the Jar file for this connection. the URL for the Jar file for this connection.



getMainAttributes
public Attributes getMainAttributes() throws IOException(Code)
Returns the main Attributes for the JAR file for this connection. the main Attributes for the JAR file for thisconnection.
exception:
  IOException - if getting the manifest causes anIOException to be thrown.
See Also:   JarURLConnection.getJarFile
See Also:   JarURLConnection.getManifest
See Also:   



getManifest
public Manifest getManifest() throws IOException(Code)
Returns the Manifest for this connection, or null if none. The returned object is not modifiable, and will throw UnsupportedOperationException if the caller attempts to modify it. the manifest object corresponding to the JAR file objectfor this connection.
exception:
  IOException - if getting the JAR file for thisconnection causes an IOException to be trown.
See Also:   JarURLConnection.getJarFile



Fields inherited from java.net.URLConnection
protected boolean allowUserInteraction(Code)(Java Doc)
protected boolean connected(Code)(Java Doc)
protected boolean doInput(Code)(Java Doc)
protected boolean doOutput(Code)(Java Doc)
static ContentHandlerFactory factory(Code)(Java Doc)
protected long ifModifiedSince(Code)(Java Doc)
protected URL url(Code)(Java Doc)
protected boolean useCaches(Code)(Java Doc)

Methods inherited from java.net.URLConnection
public void addRequestProperty(String key, String value)(Code)(Java Doc)
abstract public void connect() throws IOException(Code)(Java Doc)
public boolean getAllowUserInteraction()(Code)(Java Doc)
public Object getContent() throws IOException(Code)(Java Doc)
public Object getContent(Class[] classes) throws IOException(Code)(Java Doc)
public String getContentEncoding()(Code)(Java Doc)
synchronized ContentHandler getContentHandler() throws UnknownServiceException(Code)(Java Doc)
public int getContentLength()(Code)(Java Doc)
public String getContentType()(Code)(Java Doc)
public long getDate()(Code)(Java Doc)
public static boolean getDefaultAllowUserInteraction()(Code)(Java Doc)
public boolean getDefaultUseCaches()(Code)(Java Doc)
public boolean getDoInput()(Code)(Java Doc)
public boolean getDoOutput()(Code)(Java Doc)
public long getExpiration()(Code)(Java Doc)
public static synchronized FileNameMap getFileNameMap()(Code)(Java Doc)
public String getHeaderField(String name)(Code)(Java Doc)
public String getHeaderField(int n)(Code)(Java Doc)
public long getHeaderFieldDate(String name, long Default)(Code)(Java Doc)
public int getHeaderFieldInt(String name, int Default)(Code)(Java Doc)
public String getHeaderFieldKey(int n)(Code)(Java Doc)
public Map getHeaderFields()(Code)(Java Doc)
public long getIfModifiedSince()(Code)(Java Doc)
public InputStream getInputStream() throws IOException(Code)(Java Doc)
public long getLastModified()(Code)(Java Doc)
public OutputStream getOutputStream() throws IOException(Code)(Java Doc)
public Permission getPermission() throws IOException(Code)(Java Doc)
public Map getRequestProperties()(Code)(Java Doc)
public String getRequestProperty(String key)(Code)(Java Doc)
public URL getURL()(Code)(Java Doc)
public boolean getUseCaches()(Code)(Java Doc)
public static String guessContentTypeFromName(String fname)(Code)(Java Doc)
public static String guessContentTypeFromStream(InputStream is) throws IOException(Code)(Java Doc)
public void setAllowUserInteraction(boolean allowuserinteraction)(Code)(Java Doc)
public static synchronized void setContentHandlerFactory(ContentHandlerFactory fac)(Code)(Java Doc)
public static void setDefaultAllowUserInteraction(boolean defaultallowuserinteraction)(Code)(Java Doc)
public void setDefaultUseCaches(boolean defaultusecaches)(Code)(Java Doc)
public void setDoInput(boolean doinput)(Code)(Java Doc)
public void setDoOutput(boolean dooutput)(Code)(Java Doc)
public static void setFileNameMap(FileNameMap map)(Code)(Java Doc)
public void setIfModifiedSince(long ifmodifiedsince)(Code)(Java Doc)
public void setRequestProperty(String key, String value)(Code)(Java Doc)
public void setUseCaches(boolean usecaches)(Code)(Java Doc)
public String toString()(Code)(Java Doc)

Methods inherited from java.lang.Object
public boolean equals(Object obj)(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.