Copyright (c) 1999, 2000 Silicon Graphics, Inc. All Rights Reserved.
Related: Item & Category |
When creating certain Rhino UI components such as ItemTables, ItemViews, TreeViews, and ResultViews it is necessary to tell the component which Category it will be displaying. The UI components use this information to lookup resources that describe the Category, and to contact the server to request that the server send the Items in the Category. Simply passing the selector of the Category to the these UI components is not sufficient because the selector of the Category doesn't contain enough information to allow the components to find resources associated with the Category. To solve this problem, the name of a Java package that contains the resources relating to the Category should prepended to the Category's selector. The name of the resource file should be the same as the selector of the Category, but with a "P" appended.
For example, the resource file that controls the RhinoExampleCategory is named .../com/sgi/rhexamp/category/rhexampRhinoExampleCategoryP.properties. To request that an ItemTable show the RhinoExampleCategory, you would pass com.sgi.rhexamp.category.rhexampRhinoExampleCategory as the name of the Category.
This long name of the Category is referred to as the "fully qualified Category name" or the "package qualified Category name" in the API documents to distinguish it from the Category selector, which is referred to as "category name" or "category selector".
Since the package qualified Category name contains the Category selector, the methods that take a package qualified Category name can easily derive the Category selector when it is needed. The infrastructure always uses the category selector when communicating with the server.
In cases where the "package qualified Category name" is requested, it is legal to pass the Category selector instead. The UI components will be able to contact the server and request information about the appropriate Category, but it will have to use default display methods, since they don't have any information about how to display the Items.