Embedding Perl in HTML with Mason

Appendix A. The Mason API

To provide a convenient reference to the main elements of the Mason class hierarchy, we’ve collected the APIs of the Interpreter, Resolver, Compiler, Lexer, ApacheHandler, CGIHandler, Component, and Request classes. The parameters to each class’s new( ) method are listed in Appendix B. Many of these parameters also correspond to simple accessor methods for getting/setting their values; those methods are not listed here, so see Appendix B for a complete list.

We have attempted to show the arguments taken by each method. Replaceable text is shown in angle brackets (<>). indicating a value you must specify. An ellipsis (...) indicates a list of values. Optional arguments are indicated by square brackets ([]). An optional list of arguments doesn’t get both kinds of brackets, because we figure that’s just a list with no elements in it. If alternate sets of parameters can be given (such as comp_source versus comp_file for the Interpreter’s make_component( ) method), we sometimes indicate this by separate listings.

We intend this appendix to be a quick reference; in many cases the official Mason documentation will provide more detail.

Interpreter

The Interpreter is the main entry point for Mason and coordinates the efforts of several other classes. The default Interpreter class is HTML::Mason::Interp .

new(<parameters...>)

Creates a new Mason Interpreter and returns it. See Appendix B for a list of parameters accepted.

Object Properties

compiler( )

Returns the Compiler ...