Class: URI

• Inheritance
• Class protocol
  • accessing
  • escape
  • instance creation
• Instance protocol
  • accessing
  • comparing
  • converting
  • printing & storing
  • subclass responsibility
  • testing

Inheritance:

   Object
   |
   +--URI
      |
      +--HierarchicalURI

Package:

stx:libbasic2

Category:

Net-Resources

Version:

rev: 1.15 date: 2008/07/11 09:46:01

user: sr

file: URI.st directory: libbasic2

module: stx stc-classLibrary: libbasic2

Class protocol:

 attributes

 classForScheme: aString

find a class for a given scheme name aString

 schemes

answer the schemes supported by an URI-class.
Concrete subclasses redefine this to answer an array of scheme names

 transferBufferSize

 escape: aString allow: additionalCharacters on: aStream

 unEscape: aStream

convert escape sequences to the original characters

 fromString: aString

create an URI from a given String

 fromString: aString onError: exceptionBlock

create an URI from a given String

Instance protocol:

 scheme

return primary scheme of the class.
Concrete subclasses may redefine this

 scheme: aString

 = anURI

 hash

 asURI

 printOn: aStream

 publicPrintOn: aStream

print, but omit password information.
Subclasses which know about secret information have to redefine this

 exists

return true if the resource represented by this uri exists

** This method raises an error - it must be redefined in concrete classes **

 readStreamDo: aBlock

evaluate a block with the read stream as first argument
and a dictionary containing attributes as second argument.
The stream is closed after aBlock has been evaluated.
Attributes may be the mime type (key #MIME)

** This method raises an error - it must be redefined in concrete classes **

 readStreamsDo: aBlock

evaluate the block with a Collection of streams as first argument
and a dictionary containing attributes as second argument,
- a collection with a stream on a single file,
- or a collection with streams on a directorie's files, but not recursive

The streams are closed after aBlock has been evaluated.
Attributes may be the mime type (key #MIME)

** This method raises an error - it must be redefined in concrete classes **

 writeStreamDo: aBlock

evaluate a block with the write stream as first argument
and a dictionary containing attributes as second argument.
The stream is closed after aBlock has been evaluated.
Attributes may be the mime type (key #MIME)

** This method raises an error - it must be redefined in concrete classes **

 isRemote

return true, if this is a remote URI