Class: NameSpace

• Inheritance
• Description
• Related information
• Class protocol
  • Compatibility-VW5.4
  • accessing
  • enumerating
  • fileOut
  • fileOut-xml
  • inspecting
  • instance creation
  • printing & storing
  • queries

Inheritance:

   Object
   |
   +--NameSpace
      |
      +--Authentication
      |
      +--CharacterEncoderImplementations
      |
      +--Comanche
      |
      +--Demos
      |
      +--Dolphin
      |
      +--FCGI
      |
      +--HTML
      |
      +--ReadMe
      |
      +--Squeak
      |
      +--SunRPC
      |
      +--Tools
      |
      +--V
      |
      +--XML

Package:

stx:libbasic

Category:

Kernel-Classes

Version:

rev: 1.69 date: 2009/12/03 10:42:57

user: stefan

file: NameSpace.st directory: libbasic

module: stx stc-classLibrary: libbasic

Author:

Claus Gittinger

Description:

A NameSpace is actually a dummy class, providing a home
for its private classes. 
Thus, internally, the same mechanism is used for classes in
a NameSpace and private classes.
This has two advantages:
    - we only need one mechanism for both namespaces
      and private classes

    - there are no possible conflicts between a class
      and a namespace named alike.

Related information:

    Behavior
    ClassDescription
    Class
    Metaclass
    PrivateMetaclass

Class protocol:

 defineClass: name superclass: superclass indexedType: indexed private: private instanceVariableNames: instVars classInstanceVariableNames: classInstVars imports: imports category: category

 defineClass: name superclass: superclassOrName indexedType: indexed private: private instanceVariableNames: instVars classInstanceVariableNames: classInstVars imports: imports category: category attributes: annotations

VW5i compatibility class/namespace creation

 defineNameSpace: nameSymbol private: private imports: imports category: category

 allClasses

 allClassesWithAllPrivateClasses

 at: classNameSymbol

return a class from the namespace defined by the receiver

 at: classNameSymbol ifAbsent: exceptionBlock

return a class or an alternative
from the namespace defined by the receiver

 at: aKey ifPresent: aBlock

try to retrieve the value stored at aKey.
If there is nothing stored under this key, do nothing.
Otherwise, evaluate aBlock, passing the retrieved value as argument.

 at: classNameSymbol put: aClass

add a class to the namespace defined by the receiver

 classNamed: aString

return the class with name aString, or nil if absent.
To get to the metaClass, append ' class' to the string.

 classNames

 includesKey: aClassNameStringOrSymbol

return true if such a key is present

 loadedClassNamed: aString

return the class with name aString, or nil if absent.
To get to the metaClass, append ' class' to the string.
Do not autoload the owning class of a private class.

 package

 allBehaviorsDo: aBlock

enumerate all classes in this namespace

 allClassesDo: aBlock

enumerate all classes in this namespace

 allMethodsDo: aBlock

enumerate all methods in this namespace's classes

 allMethodsWithSelectorDo: aBlock

enumerate all methods in the Smalltalk namespace's classes

 keys

enumerate all class names in this namespace

 keysDo: aBlock

enumerate all class names in this namespace

 fileOutDefinitionOn: aStream

redefined to generate another definition message

 fileOutXMLDefinitionOn: aStream

redefined to generate another definition message

 inspectorClass

redefined to launch a DictionaryInspector
(instead of the default Inspector).

 fullName: aFullNameSpacePathName

given a possibly nested name of a namespace, create all required
intermediate spaces (if not already existing) and return the
bottom-level space.

 name: aStringOrSymbol

create a new nameSpace, named aStringOrSymbol.
Notice, that the nameSpace is created in the current one -
dont get confused; we recommend, not to nest them too much.

 new

catch new - namespaces are not to be created by the user

 displayString

return a printed represenation - here, a reminder is appended,
that this is not a regular class

 allNameSpaces

return a list of all namespaces

 allNameSpacesIn: anEnvironment

return a list of all namespaces

 allNamespaces

return a list of all namespaces

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 allNamespacesIn: anEnvironment

return a list of all namespaces

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 canHaveExtensions

return true, if this class allows extensions from other packages.
Private classes, namespaces and projectDefinitions dont allow this

 hasNameSpaces

return true - if I support sub-namespaces

 hasNamespaces

return true - if I support sub-namespaces

** This is an obsolete interface - do not use it (it may vanish in future versions) **

 isNameSpace

return true, if the receiver is a nameSpace.
Unconditionally true here for subclasses - my subclasses are namespaces

 isRealNameSpace

return true, if the receiver is a nameSpace, but not Smalltalk (which is also a class).
Unconditionally true here for subclasses - my subclasses are namespaces

 isTopLevelNameSpace

 isTopLevelNamespace

obsolete - use isTopLevelNameSpace

** This is an obsolete interface - do not use it (it may vanish in future versions) **