Zerbitzuak

Osumi Framework-eko zerbitzuak negozio-logika, partekatutako eragiketak edo osagai, modulu eta zereginetan erabilitako erabilgarritasun-funtzioak kapsulatzen dituzten klase berrerabilgarriak dira.

Zerbitzuek honako hauetan laguntzen dute:

• Logika bikoiztua saihesten.
• Domeinu-portaera antolatzen.
• Modeloekin edo kanpoko APIekin elkarreraginak zentralizatzen.
• Osagaiak orkestrazioan eta aurkezpenean zentratuta mantentzen.

1. Zer da zerbitzu bat?

Zerbitzu batek OService hedatzen du.

Framework-aren logging, konfigurazio eta cache baliabideak erabil ditzake.

2. Zerbitzu bat sortzea

Aplikazioaren zerbitzuak hemen gordetzen dira:

src/Service/

Adibidea:

namespace Osumi\OsumiFramework\App\Service;

use Osumi\OsumiFramework\Core\OService;

class UserService extends OService {
	public function getUserById(int $id): ?User {
		return User::findOne([
			'id' => $id
		]);
	}
}

3. Zerbitzu bat osagai batean injektatzea

Zerbitzuak exekutatzen den kode batetik injektatu behar dira, adibidez eraikitzailetik:

class MyComponent extends OComponent {
	private ?UserService $us = null;

	public function __construct() {
		parent::__construct();

		$this->us = inject(
			UserService::class
		);
	}
}

4. Zerbitzu bat osagai batean erabiltzea

Ohiko fluxua hau da:

1. Eskaeraren edo DTOaren datuak irakurri, beharrezkoa denean Middlewareek argitaratutako konfiantzazko testuingurua barne.
2. Negozio-logika zerbitzu bati delegatu.
3. Osagaiaren irteera prestatu.

public function run(ORequest $req): void {
	$id = $req->getMiddlewareValue(
		'Login',
		'id'
	);

	if (!is_int($id)) {
		return;
	}

	$this->user = $this->us->getUserById(
		$id
	);
}

5. Zerbitzu baten bizi-zikloa

OService-k framework-aren hainbat baliabidetarako sarbidea eskaintzen du:

• logging-a
• aplikazioaren konfigurazioa
• cachea

6. Izenak eta kokapena

Erabili:

src/Service/UserService.php

eta klase-izenak:

UserService
OrderService
PaymentService

7. Praktika onak

• Mantendu zerbitzuak egoerarik gabe ahal denean.
• Taldekatu lotutako funtzionaltasuna.
• Saihestu errendatzea edo irteera zuzena.
• Mantendu eskaera/erantzun ardura zeharkakoak Middlewareetan.
• Mantendu sarrera-balidazioa DTOetan.
• Utzi osagaiei eskaera → zerbitzua → modeloa → txantiloia fluxua orkestratzen.

8. Noiz erabili zerbitzu bat

Erabili zerbitzu bat negozio- edo domeinu-logika berrerabilgarria behar denean.

Ez erabili zerbitzu bat honako kasu hauetan:

• Logika eskaera/erantzun ardura zeharkakoa bada eta Middleware baterako egokiagoa bada.
• Logika aurkezpen edo errendatze-logika espezifikoa bada.
• Logika DTO batekin hobeto adierazten den sarrera-balidazioa bada.

9. Laburpena

Zerbitzuek negozio-logika berrerabilgarria eskaintzen dute eta osagaiak, Middlewareak eta DTOak beren arduratan zentratuta mantentzen laguntzen dute.