Introduction to Roxen Modules

Roxen's native programming interface is available through the roxen module API. Modules can be conceptually categorized by their type; parser modules (unformally also known as "tag modules") add custom tags to the RXML parser, location (or filesystem) modules serve entire documents in a portion of the virtual namespace of the server, logger modules take notes of the traffic passing through the server and so on. Depending on what task a module is trying to accomplish, it will be of one or more of the available module types. The module type establishes the relationship between roxen and the module, and determines when and how the module will be called into action.

All modules have access to the entire roxen API, and there is no difference between a module delivered with roxen and a module developed by a third party.

Roxen modules are .pike files implementing at least the methods required by its module types(s), and probably others as well. All modules must inherit module.pike, which besides implementing stubs for API functions marked as "optional" in this manual, also adds mnemonic names for various constants, among others, the types.

The rest of this chapter is devoted to describing the specifics of the array of module types, their API methods and where they fit in the big picture.

		Introduction to Roxen Modules Roxen's native programming interface is available through the roxen module API. Modules can be conceptually categorized by their type; parser modules (unformally also known as "tag modules") add custom tags to the RXML parser, location (or filesystem) modules serve entire documents in a portion of the virtual namespace of the server, logger modules take notes of the traffic passing through the server and so on. Depending on what task a module is trying to accomplish, it will be of one or more of the available module types. The module type establishes the relationship between roxen and the module, and determines when and how the module will be called into action. All modules have access to the entire roxen API, and there is no difference between a module delivered with roxen and a module developed by a third party. Roxen modules are `.pike` files implementing at least the methods required by its module types(s), and probably others as well. All modules must inherit `module.pike`, which besides implementing stubs for API functions marked as "optional" in this manual, also adds mnemonic names for various constants, among others, the types. The rest of this chapter is devoted to describing the specifics of the array of module types, their API methods and where they fit in the big picture.