Código PHP usando ArgoUML

php code
Estándar

ArgoUML es una aplicación de diagramado de UML escrita en Java y publicada bajo la Licencia BSD. Dado que es una aplicación Java, está disponible en cualquier plataforma soportada por Java. ArgoUML no es solo una herramienta de modelado de uso libre; sino también un proyecto de desarrollo de código abierto en que estamos invitados a participar.

PHP es uno de los lenguajes más usado y extendidos para la programación web. En las versiones más recientes del lenguajes y desde la versión 4 se vienen agregando y mejorado en el lenguaje, un conjunto de características que lo convierten ya en en un lenguaje orientado a objetos. De modo que ya es posible modelar nuestras aplicaciones y programas en PHP usando UML como lenguaje de modelado.

Tenemos varias razones para modelar nuestro software entre ellas:

  • Proveer una representación consistente en todo el ciclo de vida.
  • Mejor interacción entre el usuario/analista/diseñador.
  • Poder evaluar el impacto de cambios conceptuales y estructurales en nuestro software.
  • Agilizar el las labores de programación en etapas iniciales dado que permite abordar problemas complejos y simples mediante una representación universal.

Interfaz de usuario

Interfaz de ArgoUML

La interfaz se encuentra distribuida de la forma en que varios modeladores e IDE’s  se encuentran organizados.

  1. Barra de menús y herramientas en la parte superior.
  2. Un explorador del proyecto y los modelos a la izquierda, que permite organizar los elementos en distintas perspectivas.
  3. En el centro el área de diseño e inmediatamente sobre esta un barra de herramientas con los objetos permitidos en el diagrama.
  4. La sección inferior corresponde  a las propiedades del objeto seleccionado.

Dado que uds. mismos pueden explorar la interfaz de esta herramienta podemos centrarnos en su uso y en su aplicación al desarrollo con PHP mediante un ejemplo practico.

El caso de estudio

La aplicación deberá manejar clientes (se guarda su nombre, dirección, teléfono y e-mail), que pueden realizar pedidos p de productos, de los cuales se anota la cantidad en stock. Un cliente puede tener una o varias cuentas para el pago de los pedidos. Cada cuenta está asociada a una tarjeta de crédito, y tiene una cierta cantidad disponible de dinero, que el cliente debe aumentar periódicamente para poder realizar nuevos pedidos.

Un cliente puede empezar a realizar un pedido sólo si tiene alguna cuenta con dinero disponible. Al realizar un pedido, un cliente puede agruparlos en pedidos simples o compuestos. Los pedidos simples están asociados a una sola cuenta de pago y (por restricciones en la distribución) contienen un máximo de 20 unidades del mismo o distinto tipo de producto. A su vez, un pedido compuesto contiene dos o más pedidos, que pueden ser simples o compuestos. Como es de esperar, el sistema debe garantizar que todos los pedidos simples que componen un pedido compuesto se paguen con cuentas del mismo cliente. Además, sólo es posible realizar peticiones de productos en stock.

Existe una clase (de la cual debe haber una única instancia en la aplicación) responsable del cobro, orden de distribución y confirmación de los pedidos. El cobro de los pedidos se hace una vez al día, y el proceso consiste en comprobar todos los pedidos pendientes de cobro, y cobrarlos de la cuenta de pago correspondiente. Si una cuenta no tiene suficiente dinero, el pedido se rechaza (si es parte de un pedido compuesto, se rechaza el pedido entero). Una vez que el pedido está listo para servirse, se ordena su distribución, y una vez entregado, pasa a estar confirmado.

Solución

(Los colores usados se basan en la definición de arquetipos)

Explorando algunas características

ArgoUML tiene varios conjuntos de criticas de diseño que pueden ayudarnos a mejorar nuestros modelos y software. en el menú contextual de los elementos podemos ver las criticas que son aplicables así como la gravedad de las mismas.

También es posible ver la cantidad total de criticas por grado de prioridad.

Podemos documentar cualquier elemento, además de ser muy útil nos permitirá mantener un código bien documentado y que pueda ser entendido por otros, y utilizar estos comentarios para generar documentación de referencia con programas como phpDocumentor.

Es posible explorar el código de un elemento en diferentes lenguajes soportados

Generando el código y actualizando nuestro modelo

La generación de código es unas de las características que más me agrada de este modelador. Me permite crear rápidamente

crear las definiciones básicas de las clases y otros elementos, que luego puedo especificar con mayor detalle de acuerdo a las necesidades. Todo sin perdida de código al actualizar mi modelo.

Simplemente debemos seleccionar las clases y los lenguajes para los que generaremos el código así como la ruta de destino y estamos listos para continuar programado en cuanto generamos el código. Entre los lenguajes soportados están PHP 4 y 5, Java y C++.

En el código generado tendremos un archivo por cada elemento, también se generaran los paquetes o directorios en caso que hayamos agrupado en paquetes los elementos de nuestro modelo.

Se siguen las buenas prácticas de nombrado para los archivos. Esto resulta conveniente sobre todo cuando tenemos una gran cantidad de elementos (clases, paquetes, interfaces y otros) que nos resultaría difícil recordar lo que contienen labor que resultaría aun más engorrosa para otros que necesiten revisar nuestro código.

El código generado integra los comentarios y demás elementos informativos que hayamos incluido algunos de estos pueden configurarse a nivel global, de proyecto o del elemento de diseño.


Las secciones que vemos entre estos comentarios que contienen la palabra section son las zonas donde podemos ingresar nuestro código sin tener que preocuparnos porque sea sobre escrito al regenerar el código una vez que hayamos realizado cambios.

Dado que los se guardan archivos separados por cada elemento ArgoUML se encarga de agregar las inclusiones necesarias basado en las relaciones entre elementos y los tipos de parámetros y atributos.

Entre las herramientas de uso libre para ingeniería de software ArgoUML es una de las que más me agrada dado que además de ser de código abierto. Me permite hacer todo lo que necesito sin tener que usar software propietario. Puedo portar mis modelos a casi cualquier otra herramienta exportandolo como un XMI. Creo que pude contribuir al uso de las características de orientación a objetos de este lenguaje con tanto potencial y que se encuentra en evolución constante. Características cuyo uso aun no se encuentra ampliamente difundido entre muchos programadores, pese a todo el esfuerzo puesto en ello.

Finalmente les dejo por acá algunas referencias para que puedan continuar aprendiendo acerca de estos temas.

Clases y Objetos en PHP. [http://www.php.net/manual/es/language.oop5.php]

ArgoUML – Página oficial del proyecto. [http://argouml.tigris.org/]

OMG – Índice de especificaciones [http://www.omg.org/spec/index.htm]

PHP 5.+ el C++ de la web

Estándar

Me parece una analogía interesante este título, porque C++ es uno de los lenguajes de programación mas extendidos de geográficamente hablando y en lo que a usos y aplicaciones compete. Casi cualquier software que podamos imaginarnos que utilizamos hoy guarda alguna relación con este lenguaje. Esto es porque compiladores, interpretes, maquinas virtuales, frameworks o sistemas operativos esta desarrollado usando C, C++ o algún descendiente o derivado de estos.

Pero el objetivo no es hablar de C++, hablaremos de PHP. Entonces ¿porque la analogía? se preguntaran algunos. Pues básicamente porque PHP es el lenguaje más extendido en la web. Cuando el internet era como el viejo oeste, antes de que se descubriera el oro en el, PHP hacia su debut en este terreno. La evolución de PHP me parece un tanto curioso ya que nace para la web y luego se va convirtiendo en un lenguaje de propósito general. Casi la mayoría de los lenguajes de programación ha seguido un curso inverso al de PHP, desde lenguaje de propósito general hasta desarrollar extensiones o versiones para web. Mucho de lo que se usa en la web esta escrito en parte en PHP, entre esto encontramos paneles de administración, clientes de bases de datos, clientes de correos, servicios de datos, gran parte de nuestras páginas favoritas, CMS, etc.. para darnos una idea.

Un dato curioso

Casi siempre que me encuentro con un viejo desarrollador que programa con PHP noto en el una cierta resistencia al uso de las nuevas características del lenguaje. Las encuentra poco relevantes o simplemente no esta interesado en ello. Es como si para ellos el tiempo se hubiese congelado en la evolución de este lenguaje, y avocan siempre por sus ancestros menos evolucionados. Pues les tengo una noticia, la extinción es algo inminente, porque es el curso que toma todo en el mundo, desde los seres vivos hasta la tecnologías se ven relegados por sus versiones mejor adaptadas, y el rechazar esta realidad nos convierte en parte del conjunto destinado a extinguirse. No digo que no haya que saber de lo que precede a lo actual, “nunca hay que olvidar de donde se viene”, pero al igual que la vida en nuestro entorno de trabajo no podemos vivir en el pasado mientras el mundo exterior continua su marcha.
Continúan las semejanzas

Dirán algunos ¿en que se parece PHP a C++? Pues les diré que tienen algunas características comunes. Ambos soportan programación procedimental, funcional y orientado a objetos, aunque hay diferencias en la forma en que implementan la orientación a objetos dado que este desarrollo de PHP se ha visto más influenciado por lenguajes como Java. Al igual que C y C++, PHP cuenta con un gran conjunto de librerías y extensiones para todo tipo de interacciones, servicios web, interacción con el shell del sistema operativo, manipulación de archivos, edición de imágenes, tratamiento y manipulación de cadenas y más.

Creo que una de las grandes ventajas de en lo que a funcionalidad se refiere es el número de librerías para interacción con bases de datos. En este sentido el desarrollo de PDO puede darle una ventaja más en esto al pasar de muchos controladores para cada SGBD a una capa de abstracción de acceso a datos más ligera y fácil de implementar para cada manejador, es lo que JDBC en Java, provee por ahora menos funciones pero permite una interacción mas limpia y resulta fácil de migrar. Algunos aducirán que MDB solucionaba esto, pero esto es algo que no es un script es parte del lenguaje en si mismo, así que dejemos de intentar reinventar la rueda.

Otras de las similitudes es que PHP esta disponible en casi todas las plataformas, puede bien ser usado como interprete o como modulo con un servidor web entre estos IIS y Apache. es decir que pueden correr sus programas en donde sea. Gracias a algunas extensiones es posible programar aplicaciones de escritorio utilizando PHP GTK.

El soporte para programación orientada a objetos es relativamente reciente, en las últimas versiones estables disponibles, estas características están bastante maduras. Aunque para aquellos que conocieron como se trabajaba con clases y objetos ne la versión 4 se darán cuenta de que es algo muy distinto en versión 5 o superior. Pero no es mi objetivo mostrar acá las nuevas características del lenguaje, es mejor si eso lo investigan uds. mismos consultando el manual siempre disponible en php.net. Hablaremos sin embargo de algunas de las características y tecnologías prometedoras y algunos buenos y malos hábitos.

Dejando los malos hábitos
Otras de las semejanzas PHP – C++ es que si no se tienen buenos hábitos de programación y codificación, y no suele documentar mucho su código, el mantener y depurar un programa o modulo puede resultar una tarea infernal. Para los que han trabajado con C o C++ se darán cuenta de que muchos de los errores provienen de aspectos mal gestionados o no gestionados por el programador como la memoria, los tipos de datos, lo valores contenidos en  las variables en un momento dado y otros. En PHP se tienen casi una cantidad de problemas semejante, el hecho de que PHP sea un lenguaje débilmente tipado conlleva una cantidad de problemas con ello, es una arma de doble filo.

Por ejemplo, si bien puedo utilizar una variable para contener distintos tipos de dato al realizar operaciones con la misma necesito validar el tipo de dato contenido, su previa declaración y existencia, para saber si es posible o no aplicarle o utilizarla con una función en particular. Igualmente el retorno de funciones y métodos no tiene un tipo especifico, si lo tiene. con lo que no se puede tener certeza del resultado o del valor retornado, si se desea utilizar posteriormente. Existe ademas una cierta cantidad y tipos de errores que pueden producirse en tiempo de ejecución que no causan un termino o la no ejecución de un bloque de código, lo que puede resultar en que se llegue a un resultado no deseado o se desencadene un error que se pueda frenar la ejecución.

Análogo a los punteros de C++ en PHP el uso extensivo de matrices es uno de sus grandes potenciales y también una de los grandes problemas, por falta de una correcta gestión. Debemos tener presente siempre que en entornos de producción hay limites a la cantidad de memoria disponible, aunando a esto el uso incorrecto de las claves se pueden llegar a tener muchos problemas al usar matrices. PHP no es Fortran en lo que a gestión de matrices y potencia de cálculos vectoriales se refiere, pero cuenta con una gama de funciones bien surtida para la manipulación, búsqueda y ordenación ser refiere.

Otra mala práctica, remanente en unos pocos programadores, es el embeber html  u otro código dentro del script php. He dicho embeber html en el php y no embeber php en el html que resultan dos cosas diferentes, algo que algunos terminan confundiendo. El embeber es una práctica que debe limitarse al mínimo posible. No solo porque no es “elegante”, sino porque ya hay motores de plantillas más o menos maduros que facilitan esto, porque facilita el dar mantenimiento al código y separar nuestras capas de datos o modelo de negocios de nuestra capa de presentación, hace mas simple los desarrollos futuros.

Debemos aprender a escuchar y poner en práctica las recomendaciones de Zend y la comunidad de desarrolladores. Si una función esta obsoleta, créalo es obsoleta y use el reemplazo. Si se dicen que una determinada variable es el remplazo de otra úsela en sus programas. Si esta usando una versión de PHP no intente hacerlo funcionar como una versión inferior a menos que sea absolutamente necesario. Al menos lea las referencias de funciones, novedades y diferencias de la versión que utiliza. Usemos las cosas para lo que son y como debe ser, las expresiones booleanas deben recibir valores o expresiones booleanos, los que lo hacen saben de lo que les hablo, usar variables no definidas, con valores nulos, numéricos o de cadena cuyo valor pueda ser evaluado como booleano. Se deben usar los tipos de dato correctamente, validar o forzar su tipo si es necesario y evitar las asignación de datos de otro tipos en esas variables. Debe tenerse presente la versión para la que se esta escribiendo el código. A partir de PHP 5 existe un nuevo nivel de error E_STRICT que incluye tipos de errores de tipo estricto de la versión esto puede ayudarnos a detectar y corregir aquellos segmentos en que estamos usando código no acorde a las últimas versiones estables, también esta disponible la función version_compare que algunos herramientas CASE incluyen en el código generado para validar la ejecución del en dependencia de la versión del interprete.

Aprendamos a trabajar con objetos, como debe ser. No mezcle sintaxis de versiones diferentes.  Establezca el tipo de objetos en los argumentos de los métodos. Saquemos provecho real de características como la visibilidad, la unificación de constructores y los métodos especiales, asignemos los valores por defecto a los parámetros que puedan ser opcionales. Dejemos de usar los objetos como arreglos, prácticas como la asignación y uso de atributos no declarados no son recomendables. Procuremos mantener separadas nuestras capas de presentación, modelo de negocios y acceso a datos. Saquemos máximo provecho de los paradigmas de programación soportados por el lenguaje utilizando el tipo adecuado al contexto o problema solucionar.

Buenas prácticas

Finalmente creo que estos dos lenguajes (PHP y C++) si tienen varias similitudes, no solo en los problemas que se presentan al programar con ambos, sino también en las bondades que cada uno provee. PHP es un lenguaje con gran potencial, pero al igual que las demás cosas creadas por el ser humano todo depende del uso que se le de. Con el Objetivo de que mejoren en los aspectos que necesiten les dejo un par de enlaces donde pueden explorar las mejoras prácticas que cada quien puede usar en sus proyectos o en su estilo de programación. Mejores prácticas de desarrollo en PHP, Guía de buenas practicas en PHP, Manual de phpDocumentor, Zona PHP – ¿Qué esperar de PHP 5 ?.

Motores y lenguajes de platillas para PHP

Estándar

Los motores de plantillas resultan hoy un componente sin el cual sería prácticamente inconcebible un framework o cms moderno. A pesar de esto el avance en lo que respecta a reducción del acoplamiento con las tecnologías utilizadas y cohesión con otros componentes del framework o cms, aun no hay tantos motores como se podría pensar.

Smarty es uno de los motores de plantillas más populares para PHP, quizá porque esta bien documentado y cuenta con un gran numero de extensiones que permiten generar varios componentes de la interfaz con solo configurar unos pocos parámetros. Aunque en lo personal considero que más que separar las capas este motor agrega otra, ya que el tratamiento de variables y el funcionamiento mismo siguen altamente relacionados con la plataforma.

En este artículo sin embargo vamos a hablar de dos tecnologías con buenas perspectivas de alcanzar un uso extenso en largo plazo.
TAL (Template Attribute Language)

Es un lenguaje de plantillas usado para generar paginas HTML y XML. Fue desarrollado inicialmente para Zope pero es usando en otros proyectos Python. Cuenta con una expansión del lenguaje METAL (Macro Expansion TAL) que permite reutilizar código de otras plantillas de un forma muy practica. Este lenguaje de plantillas cuenta ya con implementaciones en PHP, JavaScript, Java, Perl y hojas d estilos XSL. Entre sus bondades encontramos el hecho de que facilita la edición de las plantillas por diseñadores desde los editores convencionales, sin que estos necesiten mayores conocimientos del lenguaje y permite migrar de plataforma con un mínimo de modificaciones.


XML y XSL(Extensible Stylesheet Language)

XML es una de los lenguajes mas utilizado para el intercambio de datos. Tiene la ventaja de estar basado en estándares y es completamente legible por una gran varidad de interpretes, cuanta con librerías para tratamiento y manipulación de documentos en la mayoría de los lenguajes utilizados para el desarrollo web. Al ser totalmente independiente no solo de la plataforma y de las librerías de manipulación de documentos en cada lenguaje permite centrarse solo en el contenido y su semántica, delegando la forma en que los datos serán procesados y presentados a la plataforma a utilizar.

En el caso de las web los XSL constituyen un forma excelente de aplicar transformaciones a los datos convertir un documento XML que contiene un conjunto de datos en una web en cualquier formato imaginable con una mínima intervención del lenguaje o plataforma. Estas tecnologías tienen grandes posibilidades de ser algunas de las más utilizadas, con el aumento del las transferencia asíncronas de datos y el creciente numero de aplicaciones y servicio que comparten un mismo conjunto de datos a través de la red.
Pros y contras
Estos lenguajes facilitan el intercambio de datos entre distintas aplicaciones, incluso el uso de los mismos datos de formas diversas. Ademas de que los formatos de estos lenguajes obligan a los desarrolladores a crear aplicaciones cuyas capas de presentación y del modelo de negocios se encuentren realmente separadas. Algo que frecuentemente vemos al desarrollar utilizando Smarty es que los programadores o desarrolladores legan muchas cosas al motor de plantillas. Se agregan nuevas funciones, mucha de la evaluación de condicionales se embebe en la platilla, se utilizan y evalúan variables no declaradas, entre otras cosas. Todo ello no solo porque PHP lo permite si no producto de malos hábitos de programación.

A pesar la gran importancia que dan a la homologación que persiguen estas tecnologías alternas, algunas de sus implementacines desafortunadamente aun carecen de una gestión de cache robusta; pero estos es algo en lo que se esta trabajando y de figura como una alternativa para la web.

Tecnologías como estas y otras semejantes ha demostrado de sobrada manera que en las web aquellas tecnologías que se adapten mejor a una gran variedad de usos independiente mente de la plataforma ocupara con el tiempo un lugar preponderante en los desarrollos de aplicaciones y nuevas tecnologías basadas en web.