Name

Object::Relation::Language - Object::Relation localization class

Synopsis

  # Add localization strings.
  package MyApp::Language::en;
  use Object::Relation::Language::en;
  Object::Relation::Language::en->add_to_lexicon(
    'Thingy' => 'Thingy',
    'Thingies' => 'Thingies',
  );

  # Use directly.
  use Object::Relation::Language;
  my $lang = Object::Relation::Language->get_handle('en_us');
  print $lang->maketext($msg);

Description

This class handles Object::Relation localization. To add this functionality, it subclasses Locale::Maketext and adds a few other features. One of these features is that failure to find a localization string will result in the throwing of a Object::Relation::Exception::Fatal::Language exception.

But since the Object::Relation framework is just that, a framework, this class functions as the base class for the localization libraries of all Object::Relation applications. Those applications can add their own localization strings libraries via the add_to_lexicon() method.

Those who wish to add new localizations to the Object::Relation framework should consult the en subclass for a full lexicon.

Class Interface

Class Methods

add_to_lexicon

  Object::Relation::Language::en->add_to_lexicon(
    'Thingy' => 'Thingy',
    'Thingies' => 'Thingies',
  );

Adds new entries to the lexicon of the class. This method is intended to be used by the localization libraries of Object::Relation applications, which will have their own strings that need localizing.

Instance Interface

Instance Methods

init

This method is used internally by Locale::Maketext to set up failed localization key lookups to throw exceptions.

Copyright and License

Copyright (c) 2004-2006 Kineticode, Inc. <info@obj_relode.com>

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.