Model EstadoBrasileiro

O model EstadoBrasileiro contém informações sobre os estados brasileiros, podendo ser utilizado para auxiliar ou associar com outros
modelos. Também poderá servir de base para outros modelos.

Instalação

Não é necessário fazer a instalação deste model. Basta utilizar.

Utilização

Utilizar no controller:

class XxxsController extends AppController {
	var $name = 'Xxxs';
	var $uses = array('Xxx', 'CakePtbr.EstadoBrasileiro');

	function index() {
		$this->EstadoBrasileiro->find('list');
	}
}

Criando uma model:

App::import('Model', 'CakePtbr.EstadoBrasileiro');

class Estado extends EstadoBrasileiro {
...
}

API

A model EstadoBrasileiro estende a AppModel. Logo, todos os métodos utilizados na sua AppModel serão aplicados neste novo model.

Métodos disponíveis no model:

• listaEstados($incluirDF = true)
  • Gera uma lista com os estados, sendo a chave a sigla e o valor o nome do estado.
• todosEstados($incluirDF = true)
  • Lista os estados, mas no formato array(‘EstadoBrasileiro’ => array(array(‘sigla’ => ‘SC’, ‘nome’ => ‘Santa Catarina’), …)).
• estadoPorSigla($sigla)
  • Informa o nome do estado através da sigla. Por exemplo, passando ‘SC’ como parâmetro, é retornado ‘Santa Catarina’.
• siglaPorEstado($estado)
  • Inverso do método anterior.
• estadosDoSul()
  • Apresenta uma lista com os estados da região sul. A lista virá no mesmo formato de listaEstados.
• estadosDoSudeste()
  • Idem estadosDoSul, mas para região sudeste.
• estadosDoCentroOeste($incluirDF = true)
  • Idem estadosDoSul, mas para região centro-oeste. É possível informar se será incluído o Distrito Federal.
• estadosDoNorte()
  • Idem estadosDoSul, mas para região norte.
• estadosDoNordeste()
  • Idem estadosDoSul, mas para região nordeste.