Solstice::Controller - A virtual superclass for constructing Solstice controllers.

  package MyApp::Controller;

  use Solstice::Controller;

  our @ISA = qw(Solstice::Controller);

This is a virtual class for creating Solstice controller classes. This class should never be instantiated as an object, rather, it should always be sub-classed. This particular implementation uses Solstice::CGI to handle events by the user.

No symbols exported.

new()

Creates a new Solstice::Controller object.

build

validPreConditions()

freshen()

update()

validate()

commit()

revert()

setModel($model)

Set the data model that this controller controls.

getModel()

Get the data model that this controller controls.

setSuccessView($view)

Set the success view that this controller controls.

getStartingView()

This gets the first view that a controller produces, like the form that the controller will then manage. Must by subclassed.

setErrorView($view)

Set the error view for this controller.

getErrorView()

Get the error view for this controller.

getChildView($key)

Returns a view object for the child controller of a given key.

getChildViews($key)

Returns an array ref of view objects for all of the child controllers of a given key.

setError($error)

Sets an error object for placement into the views

getError()

Gets the error object for this controller.

getErrMsgs()

Get the error messages for this controller.

checkForm($profile)

This method takes a form profile to be passed to Data::FormValidator, and returns a Data::FormValidator::Results object.

createParam('param_name')

Adds a new param to be validated. This is required by default.

createRequiredParam('param_name')

Adds a new param to be validated. Requires user input.

createOptionalParam('param_name');

Adds a new param to be validated. Does not require user input.

createGroupDependency({ dependency_name => 'name', require => $count, fields => [ $field1, $field2] });

Allows the use of require_some...

processConstraints()

Takes all of the constraints added to a controller, transforms them into a hash for Data::FormValidator.

setInputName($location_name)

getInputName()

setOutputName($location_name)

getOutputName()

getInputObject()

getOutputObject()

setInputObject($object)

setOutputObject($object)

createChildControllerList( 'loop_name', 'var_name' )

addChildController($key,( $controller || \@controllers) )

getChildController($key)

getChildControllers($key)

returns a reference to an array of 'em.

clearChildControllers($key)

validateChildren($key)

updateChildren($key)

revertChildren($key)

commitChildren($key)

validPreConditionsChildren($key)

freshenChildren($key)

getDateTimeController($model)

Return the preferred Solstice datetime controller, or a fallback.

getRichTextController($model)

Return the preferred Solstice rich-text controller, or a fallback.

_initErrMsgs()

Initialize the error messages for this controller.

Solstice::Service, Solstice::LogService, Solstice::UserService, Solstice::ValidationParam, Solstice::CGI, Solstice::CGI::FormError, Data::FormValidator.

Catalyst Group, <catalyst@u.washington.edu>

Version $Revision: 3365 $

Copyright 1998-2007 Office of Learning Technologies, University of Washington

Licensed under the Educational Community License, Version 1.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at: http://www.opensource.org/licenses/ecl1.php

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.