<?php

/**
 * i-Educar - Sistema de gestão escolar
 *
 * Copyright (C) 2006  Prefeitura Municipal de Itajaí
 *                     <ctima@itajai.sc.gov.br>
 *
 * Este programa é software livre; você pode redistribuí-lo e/ou modificá-lo
 * sob os termos da Licença Pública Geral GNU conforme publicada pela Free
 * Software Foundation; tanto a versão 2 da Licença, como (a seu critério)
 * qualquer versão posterior.
 *
 * Este programa é distribuí­do na expectativa de que seja útil, porém, SEM
 * NENHUMA GARANTIA; nem mesmo a garantia implí­cita de COMERCIABILIDADE OU
 * ADEQUAÇÃO A UMA FINALIDADE ESPECÍFICA. Consulte a Licença Pública Geral
 * do GNU para mais detalhes.
 *
 * Você deve ter recebido uma cópia da Licença Pública Geral do GNU junto
 * com este programa; se não, escreva para a Free Software Foundation, Inc., no
 * endereço 59 Temple Street, Suite 330, Boston, MA 02111-1307 USA.
 *
 * @author    Eriksen Costa Paixão <eriksen.paixao_bs@cobra.com.br>
 * @category  i-Educar
 * @license   @@license@@
 * @package   CoreExt_Entity
 * @since     Arquivo disponível desde a versão 1.1.0
 * @version   $Id$
 */

require_once 'CoreExt/Validate/Validatable.php';

/**
 * CoreExt_Entity_Validatable interface.
 *
 * @author    Eriksen Costa Paixão <eriksen.paixao_bs@cobra.com.br>
 * @category  i-Educar
 * @license   @@license@@
 * @package   CoreExt_Entity
 * @since     Interface disponível desde a versão 1.1.0
 * @version   @@package_version@@
 */
interface CoreExt_Entity_Validatable extends CoreExt_Validate_Validatable
{
  /**
   * Configura uma coleção de CoreExt_Validate_Interface na instância.
   * @return CoreExt_Entity Provê interface fluída
   */
  public function setValidatorCollection(array $validators);

  /**
   * Retorna um array de itens CoreExt_Validate_Interface da instância.
   * @return array
   */
  public function getValidatorCollection();

  /**
   * Retorna um array de CoreExt_Validate_Interface padrão para as propriedades
   * de CoreExt_Entity.
   *
   * Cada item do array precisa ser um item associativo com o mesmo nome do
   * atributo público definido pelo array $_data:
   *
   * <code>
   * <?php
   * // Uma classe concreta de CoreExt_Entity com as propriedades públicas
   * // nome e telefone poderia ter os seguintes validadores.
   * array(
   *   'nome' => new CoreExt_Validate_Alpha(),
   *   'telefone' => new CoreExt_Validate_Alphanum()
   * );
   * </code>
   *
   * @return array
   */
  public function getDefaultValidatorCollection();
}