..
.. META INFORMATION OF TRANSLATION
..
..   $TranslationStatus: Done, waiting for revision $
..   $OriginalRevision: 11268 $
..   $TranslationAuthors: Igor Sobreira, Robson Mendonça, Walter Cruz $
..
.. INFO OF THIS FILE (DO NOT EDIT! UPDATED BY SUBVERSION)
..
..   $HeadURL$
..   $LastChangedRevision$
..   $LastChangedBy$
..   $LastChangedDate$
..


.. _howto-jython:

========================
Rodando Django no Jython
========================

.. index:: Jython, Java, JVM

Jython_ é uma implementação de Python que roda na plataforma Java (JVM).
Django roda sem hacks no Jython a partir da versão 2.5, o que significa que você
pode fazer o deploy do Django em qualquer plataforma Java.

Esse documento vai orientá-lo em como executar o Django no Jython.

.. _jython: http://www.jython.org/

Instalando o Jython
===================

Django funciona a partir da versão 2.5b3 do Jython. Baixe o Jython em
http://www.jython.org/.

Criando um container com servlets
=================================

Se você só quiser fazer experimentos com Django, pule para a próxima seção;
Django inclui um servidor web leve que você pode usar para testes, para
que você não precisa configurar nada até que esteja pronto para deploy Django
em produção

Se você quiser usar Django num site em produção, use um container Java com
servlets, como o `Apache Tomcat`_. Aplicações JavaEE completas como o
`GlassFish`_ ou `JBoss`_ também funcionam, se você precisar das funcionalidades
extras que eles incluem.

.. _`Apache Tomcat`: http://tomcat.apache.org/
.. _GlassFish: https://glassfish.dev.java.net/
.. _JBoss: http://www.jboss.org/

Instalando o Django
===================

O próximo passo será instalar o Django. É exatamente da mesma maneira a instalar
com o Python padrão, então veja :ref:`removing-old-versions-of-django`
e :ref:`install-django-code` para mais instruções.

Instalando as bibliotecas de suporte para a plataforma Jython
=============================================================

O projeto `django-jython`_ contém backends de banco de dados e comandos de
genrência para o desenvolvimento com Django/Jython. Note que os backends
embutidos do Django não irão funcionar no Jython.

.. _`django-jython`: http://code.google.com/p/django-jython/

Para instalá-lo, siga as `instruções de instalação`_ detalhas no site do projeto.
Também leia a documentação dos `database backends`_ lá.

.. _`instruções de instalação`: http://code.google.com/p/django-jython/wiki/Install
.. _`database backends`: http://code.google.com/p/django-jython/wiki/DatabaseBackends

Diferenças do Django no Jython
===============================

.. index:: JYTHONPATH

Nesse ponto, Django no Jython deve parecer praticamente idêntico ao Django rodando
no Python padrão. Porém, existem algumas diferenças a serem lembradas:

    * Lembre-se se usar o comando ``jython`` ao invés de ``python``. A documentação
      usa ``python`` por consistência, mas se você tiver usando Jython você
      precisará trocar ``python`` por ``jython`` mentalmente em todas as ocorrências

    * Similarmente, você precisará usar a variável de ambiente ``JYTHONPATH`` ao
      invés de ``PYTHONPATH``.