liferay-service-builder

Generate Liferay service and persistence code from service.xml.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/JoaoPedroAmaral/backBarbearia --skill liferay-service-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: liferay-service-builder
Source: https://github.com/JoaoPedroAmaral/backBarbearia/tree/main/.claude/skills/liferay-service-builder
Command: npx skills add https://github.com/JoaoPedroAmaral/backBarbearia --skill liferay-service-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Service Builder eliminates repetitive, error-prone boilerplate when creating models, persistence, and service layers for Liferay modules, letting developers focus on business logic instead of generated plumbing.

Core Features & Use Cases

  • Code generation: Generate model interfaces, model implementations, persistence classes, and service interfaces/implementations from a single service.xml.
  • Finders and queries: Produce typed finder methods, support dynamic queries, and enable custom SQL for complex retrieval patterns.
  • Deployment patterns: Guide on splitting API and service modules, using LocalServiceImpl for internal logic and ServiceImpl for permissioned external operations.
  • Use case: Build a Liferay module that stores domain entities, exposes secure remote services, implements efficient finders, and runs optimized custom SQL for reporting.

Quick Start

Generate models, persistence, and service layers from your service.xml using the Service Builder build step and implement business logic in LocalServiceImpl.

Frequently Asked Questions about liferay-service-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate Liferay service and persistence code from service.xml?

To generate Liferay service code, provide a valid service.xml in a Liferay workspace and run the Service Builder build step. This produces model interfaces, persistence classes, and service layers automatically.

What is the difference between LocalServiceImpl and ServiceImpl in Liferay module development?

In Liferay module development, LocalServiceImpl handles internal business logic, while ServiceImpl exposes permissioned external operations. Splitting API and service modules ensures secure remote service access.

How do I implement dynamic queries and custom SQL in Liferay Service Builder?

Liferay Service Builder supports dynamic queries and custom SQL for complex retrieval patterns. Define typed finder methods in service.xml to generate optimized persistence classes for reporting.

What do I need to run Liferay Service Builder for code generation?

Running Liferay Service Builder requires a Java build environment, a configured Liferay workspace, and a valid service.xml file. These prerequisites ensure successful model and persistence code generation.

Why should I use Liferay Service Builder instead of writing persistence layers manually?

Liferay Service Builder eliminates repetitive, error-prone boilerplate when creating models and persistence layers. It lets developers focus on business logic instead of generated plumbing code.