{"id":22954977,"url":"https://github.com/e-contract/enterprise-jsf","last_synced_at":"2026-03-17T19:19:11.837Z","repository":{"id":65922909,"uuid":"495729220","full_name":"e-Contract/enterprise-jsf","owner":"e-Contract","description":null,"archived":false,"fork":false,"pushed_at":"2026-02-28T07:28:17.000Z","size":2216,"stargazers_count":18,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2026-02-28T13:16:37.109Z","etag":null,"topics":["java","jsf","primefaces"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/e-Contract.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2022-05-24T08:12:40.000Z","updated_at":"2026-02-28T07:28:21.000Z","dependencies_parsed_at":"2023-11-23T07:30:56.489Z","dependency_job_id":"867913e0-ce65-4c94-a5fb-843f6df1c704","html_url":"https://github.com/e-Contract/enterprise-jsf","commit_stats":null,"previous_names":[],"tags_count":59,"template":false,"template_full_name":null,"purl":"pkg:github/e-Contract/enterprise-jsf","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e-Contract%2Fenterprise-jsf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e-Contract%2Fenterprise-jsf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e-Contract%2Fenterprise-jsf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e-Contract%2Fenterprise-jsf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/e-Contract","download_url":"https://codeload.github.com/e-Contract/enterprise-jsf/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/e-Contract%2Fenterprise-jsf/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30629072,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-17T17:32:55.572Z","status":"ssl_error","status_checked_at":"2026-03-17T17:32:38.732Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","jsf","primefaces"],"created_at":"2024-12-14T16:20:21.071Z","updated_at":"2026-03-17T19:19:11.831Z","avatar_url":"https://github.com/e-Contract.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Enterprise JSF\n\nThe Enterprise JSF project delivers:\n* a PDF document about writing custom JSF components.\n* a JSF component library (requires PrimeFaces).\n\nThe demo web application is available at:\nhttps://demo.e-contract.be/ejsf-demo/\n\n\n## The document\n\nThe latest version of the Enterprise JSF document is available at:\n\nhttps://github.com/e-Contract/enterprise-jsf/releases/download/enterprise-jsf-1.21.0/enterprise-jsf.pdf\n\nThe following dependencies are required for building the PDF document:\n* make\n* latex\n* PlantUML, and a `PLANTUML_JAR` environment variable pointing to the corresponding JAR.\nPlantUML can be downloaded from: https://plantuml.com\n\nBuilding this project should be possible on macOS, Linux, and FreeBSD.\n\nCompile the PDF document via:\n```\ncd doc\nmake\n```\n\nAll the examples referenced within the document can be found within the `examples` directory.\n\nWe prefer to edit the LaTeX document using TeXstudio.\nTeXstudio can be downloaded from:\nhttps://texstudio.org\n\n## The JSF component library\n\nThe Enterprise JSF library provides various JSF components.\nAn overview of all JSF tags is available at:\nhttps://demo.e-contract.be/ejsf-demo/api.xhtml\n\nThe library is compatible with the following versions of PrimeFaces:\n* 12\n* 13\n* 14\n* 15\n\nThe library is compatible with the following versions of JSF/Jakarta Faces:\n* 2.1 (most components)\n* 2.3 - Java EE 8\n* 4.0 - Jakarta EE 10\n* 4.1 - Jakarta EE 11\n\nThe JSF component library is available within the e-Contract.be public Maven repository.\nIf you use Maven, refer to the e-Contract.be Maven repository via:\n```xml\n\u003crepository\u003e\n    \u003cid\u003ee-contract\u003c/id\u003e\n    \u003curl\u003ehttps://www.e-contract.be/maven2/\u003c/url\u003e\n\u003c/repository\u003e\n```\nAdd the JSF component library to your web application WAR project via:\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ebe.e-contract.enterprise-jsf\u003c/groupId\u003e\n    \u003cartifactId\u003eejsf-taglib\u003c/artifactId\u003e\n    \u003cversion\u003e1.33.0\u003c/version\u003e\n\u003c/dependency\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.primefaces\u003c/groupId\u003e\n    \u003cartifactId\u003eprimefaces\u003c/artifactId\u003e\n    \u003cversion\u003e13.0.10\u003c/version\u003e\n\u003c/dependency\u003e\n```\nWithin you JSF pages, use the following JSF namespace declaration:\n```\nxmlns:ejsf=\"urn:be:e-contract:ejsf\"\n```\nNow you are ready to use our components, for example:\n```xml\n\u003cejsf:outputBoolean value=\"#{true}\"/\u003e\n```\nFor Jakarta EE 10 runtimes, use the following dependency:\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ebe.e-contract.enterprise-jsf\u003c/groupId\u003e\n    \u003cartifactId\u003eejsf-taglib\u003c/artifactId\u003e\n    \u003cversion\u003e1.33.0\u003c/version\u003e\n    \u003cclassifier\u003ejakarta\u003c/classifier\u003e\n    \u003cexclusions\u003e\n        \u003cexclusion\u003e\n            \u003cgroupId\u003ebe.e-contract.enterprise-jsf\u003c/groupId\u003e\n            \u003cartifactId\u003eejsf-api\u003c/artifactId\u003e\n        \u003c/exclusion\u003e\n    \u003c/exclusions\u003e\n\u003c/dependency\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003ebe.e-contract.enterprise-jsf\u003c/groupId\u003e\n    \u003cartifactId\u003eejsf-api\u003c/artifactId\u003e\n    \u003cversion\u003e1.33.0\u003c/version\u003e\n    \u003cclassifier\u003ejakarta\u003c/classifier\u003e\n\u003c/dependency\u003e\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.primefaces\u003c/groupId\u003e\n    \u003cartifactId\u003eprimefaces\u003c/artifactId\u003e\n    \u003cversion\u003e13.0.10\u003c/version\u003e\n    \u003cclassifier\u003ejakarta\u003c/classifier\u003e\n\u003c/dependency\u003e\n```\n\nNote that some JSF tags require additional runtime dependencies.\nFor example:\n```xml\n\u003cejsf:katex/\u003e\n```\nrequires the following additional dependency:\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ebe.e-contract.enterprise-jsf\u003c/groupId\u003e\n    \u003cartifactId\u003eejsf-taglib-katex\u003c/artifactId\u003e\n    \u003cversion\u003e1.33.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Running the demo web application\n\nWe use Apache Maven as build system.\nApache Maven can be downloaded from: https://maven.apache.org\n\nYou need Java JDK 17 or higher to build this project.\nHowever, we will try to keep the Enterprise JSF library compatible with Java 8 for as long as possible.\n\nBuild the project via:\n```\nmvn clean install\n```\n\nWe provide two flavors of the demo web application:\n* `ejsf-demo` targeting Java EE version 8.\n* `ejsf-demo-ee10` targeting Jakarta EE version 10.\n\n### Java EE 8 demo web application\n\nRunning the demo web application requires an application server that supports Java EE version 8.\nWe prefer WildFly as application server.\nWildFly version 26.1.3.Final is the latest version that still supports Java EE 8.\nWildFly can be downloaded from: https://www.wildfly.org\n\nStart a WildFly version 26.1.3.Final via:\n```\ncd wildfly-26.1.3.Final/bin\n./standalone.sh --server-config=standalone-full.xml\n```\n\nDeploy the demo web application via:\n```\ncd ejsf-demo\nmvn wildfly:deploy\n```\n\nTry out the demo web application via:\nhttp://localhost:8080/ejsf-demo/\n\nYou can also run the demo web application using an embedded Jetty servlet container.\nRun the demo web application with Mojarra as JSF implementation via:\n```\ncd ejsf-demo\nmvn clean jetty:run -Pmojarra\n```\nRun the demo web application with MyFaces as JSF implementation via:\n```\ncd ejsf-demo\nmvn clean jetty:run -Pmyfaces\n```\n\nRun the demo web application on the Open Liberty application server via:\n```\ncd ejsf-demo\nmvn clean package liberty:run\n```\n\nRun the demo web application on the Payara application server via:\n```\ncd ejsf-demo\nmvn clean package payara-micro:start -Ppayara\n```\n\n### Jakarta EE 10 demo web application\n\nRunning the demo web application requires an application server that supports Jakarta EE version 10.\nWe prefer WildFly as application server.\nWildFly version 39.0.0.Final is the latest version that supports Jakarta EE 10.\nWildFly can be downloaded from: https://www.wildfly.org\n\nStart WildFly via:\n```\ncd wildfly-39.0.0.Final/bin\n./standalone.sh --server-config=standalone-full.xml\n```\n\nDeploy the demo web application via:\n```\ncd ejsf-demo-ee10\nmvn wildfly:deploy\n```\n\nTry out the demo web application via:\nhttp://localhost:8080/ejsf-demo/\n\nYou can also run the demo web application using an embedded Jetty servlet container.\nRun the demo web application with Mojarra as JSF implementation via:\n```\ncd ejsf-demo-ee10\nmvn clean jetty:run -Pmojarra\n```\nRun the demo web application with MyFaces as JSF implementation via:\n```\ncd ejsf-demo-ee10\nmvn clean jetty:run -Pmyfaces\n```\n\nRun the demo web application on the Open Liberty application server via:\n```\ncd ejsf-demo-ee10\nmvn clean package liberty:run\n```\n\nRun the demo web application on the Payara application server via:\n```\ncd ejsf-demo-ee10\nmvn clean package payara-micro:start -Ppayara\n```\n\n\n### Jakarta EE 11 demo web application\n\nRun the demo web application with Mojarra as JSF implementation via:\n```\ncd ejsf-demo-ee10\nmvn clean jetty:run -Pmojarra-ee11\n```\n\nRun the demo web application with MyFaces as JSF implementation via:\n```\ncd ejsf-demo-ee10\nmvn clean jetty:run -Pmyfaces-ee11\n```\n\n\n## Integration Tests\n\nRun the Selenium based integration tests via:\n```\ncd ejsf-tests\nmvn clean test -Pintegration-tests\n```\n\n## Docker\n\nAlternatively, the Java EE application can be compiled and deployed to a WildFly Docker container\nthat is built on the fly (using the `Dockerfile`-files located in `docker/`) by entering the following command:\n```shell\nmake\n```\n\nOther useful `make` targets are:\n* `make run-ee10`: to deploy the JEE 10 version on a WildFly Docker 27.x container\n* `make docker-start-ee8`: to start the WildFly Docker 26.x container, with l/p: admin/e-contract.be\n* `make docker-start-ee10`: to start the WildFly Docker 27.x container, with l/p: admin/e-contract.be\n* `make clean`: to clean the maven project and to stop the running WildFly Docker container\n* `make mrproper`: to clean everything and remove the WildFly Docker image(s)\n* `make doc-with-docker`: uses Docker with all required dependencies installed to generate the `enterprise-jsf.pdf` file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fe-contract%2Fenterprise-jsf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fe-contract%2Fenterprise-jsf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fe-contract%2Fenterprise-jsf/lists"}