Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/pancitox77/pancitotools

Librería de utilidades
https://github.com/pancitox77/pancitotools

java javafx lib

Last synced: 3 days ago
JSON representation

Librería de utilidades

Host: GitHub
URL: https://github.com/pancitox77/pancitotools
Owner: Pancitox77
Created: 2024-12-17T23:49:07.000Z (30 days ago)
Default Branch: main
Last Pushed: 2025-01-06T18:53:26.000Z (10 days ago)
Last Synced: 2025-01-06T19:33:32.523Z (10 days ago)
Topics: java, javafx, lib
Language: Java
Homepage:
Size: 188 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# Introducción

Esta es una librería Java con múltiples utilidades.

Los nodos y clases de interfaz gráfica usan JavaFX.

> La mayoría de las clases que utilizan archivos externos se apoyan de
> la clase `Resources`. Se recomienda que se configuren las rutas antes de usar cualquier clase.
> La clase Resources convierte una ruta relativa (dentro de `resources/` como base) a una ruta absoluta.

Por defecto, las traducciones se cargan en `resources/i18n/messages.properties`, aunque se puede cambiar usando los métodos relacionados de la clase Translator.

## Dependencias

Este proyecto usa JavaFX 23.0.1 y Java 21.

---

# Herramientas

## Manejo de archivos

- **JsonTools**:
- Todos sus métodos son *estáticos*.
- Funciones de lectura/escritura de archivos json.
- Principalmente utiliza la carpeta *resources/json/* configurada en Resources.java.

## UI

### Nodos

Son nodos propios que no hay en JavaFX por defecto.

- **CircularProgress**: Es una barra de progreso que en lugar de completar una barra lineal,
va completando el círculo. Funciona como una barra de progreso estándar.

### Transiciones

Son animaciones y efectos.

- La clase `Transitions` funciona de manera estática y provee transiciones entre 2 o más nodos.
Útil para transiciones entre escenas.
- `NumberPropertyTransition` funciona como una animación de transición de propiedad (establecer
un valor dentro de un cierto tiempo) para propiedades numéricas.
- `StringPropertyTransition` es similar a NumberPropertyTransition, con la diferencia que va
cambiando un String, completando las letras faltantes.

Ademas de las transiciones propias, se incluyen todas las transiciones del paquete FXTransitions:

1. BounceInDown
2. FadeOut
3. BounceInLeft
4. FadeOutUpBig
5. BounceInRight
6. FadeOutUp
7. BounceIn
8. Flash
9. BounceInUp
10. FlipInX
11. BounceOutDown
12. FlipInY
13. BounceOutLeft
14. FlipOutX
15. BounceOutRight
16. FlipOutY
17. BounceOut
18. Flip
19. BounceOutUp
20. Hinge
21. Bounce
22. Pulse
23. CachedTimeline
24. RollIn
25. FadeInDownBig
26. RollOut
27. FadeInDown
28. RotateInDownLeft
29. FadeInLeftBig
30. RotateInDownRight
31. FadeInLeft
32. RotateIn
33. FadeInRightBig
34. RotateInUpLeft
35. FadeInRight
36. RotateInUpRight
37. FadeIn
38. RotateOutDownLeft
39. FadeInUpBig
40. RotateOutDownRight
41. FadeInUp
42. RotateOut
43. FadeOutDownBig
44. RotateOutUpLeft
45. FadeOutDown
46. RotateOutUpRight
47. FadeOutLeftBig
48. Shake
49. FadeOutLeft
50. Swing
51. FadeOutRightBig
52. Tada
53. FadeOutRight
54. Wobble

## Clases

> [!WARNING] El paquete **signals** está incompleto y no es funcional.

- **Jsonizable**: Interfaz que indica que una clase se puede convertir a su representación JSON.
- Utiliza el paquete GSON.

### Signals

Las señales funcionan como un sistema de programación reactiva.
Se definen dos funciones, la función emisora y la función receptora.

La función emisora es la que envía la señal, y la función receptora es la que recibe la señal.
Una función emisora emite su señal cuando esta función es llamada.
Una función receptora recibe la señal cuando la función emisora es llamada. Se puede configurar
para que la función receptora se ejecute en un momento determinado (antes o después de ejecutar la función emisora).

## Otras utilidades

- **Lists**: Realiza operaciones a listas. Clase estática.
- convertir lista a string y viceversa.
- comprobar que un elemento esté dentro de la lista.
- comprobar que un elemento es el último de la lista.
- ordenar una lista de strings por orden alfabético.
- **Resources**: Obtiene recursos internos desde una ruta relativa. Clase estática.
- Clase principal donde se apoya la mayor parte de la librería.
- Obtiene distintos tipos de objetos según el tipo, por ejemplo,
- una Image para imágenes,
- una URL para vistas FXML,
- ruta formateada para archivos css,
- etc
- Por defecto todas las rutas están inicializadas (si la carpeta no existe, dará error al usar un método relacionado).
- Además, puede cambiar una vista fxml por otra. Esta transición no tiene animaciones.
- **Strings**: Realizar operaciones sobre strings. Clase estática.
- convertir a mayúsculas la primera letra de un string.
- convertir a mayúsculas la primera letra de cada palabra de un string.
- **Translator**: Obtiene traducciones a partir de llaves. Internacionalización. Clase estática.
- Las traducciones se obtienen de *resources/i18n/messages.properties*.
- No depende de la clase `Resources`.
- Las traducciones se extraen de un archivos de propiedades, no se traduce como tal.