https://github.com/ilyamatsuev/apex-trigger-framework

Trigger framework for Apex simplifying the trigger handlers dispatching
https://github.com/ilyamatsuev/apex-trigger-framework

apex library salesforce trigger-framework triggers

Last synced: about 1 month ago
JSON representation

Trigger framework for Apex simplifying the trigger handlers dispatching

• Host: GitHub
• URL: https://github.com/ilyamatsuev/apex-trigger-framework
• Owner: IlyaMatsuev
• License: mit
• Created: 2020-07-10T21:55:10.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2022-08-21T22:53:05.000Z (over 2 years ago)
• Last Synced: 2024-10-12T13:12:41.622Z (2 months ago)
• Topics: apex, library, salesforce, trigger-framework, triggers
• Language: Apex
• Homepage:
• Size: 87.9 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Apex Trigger Framework

[![Scratch org CI](https://github.com/IlyaMatsuev/Apex-Trigger-Framework/actions/workflows/scratch-org-ci.yml/badge.svg?branch=main)](https://github.com/IlyaMatsuev/Apex-Trigger-Framework/actions/workflows/scratch-org-ci.yml)

[![codecov](https://codecov.io/gh/IlyaMatsuev/Apex-Trigger-Framework/branch/main/graph/badge.svg?token=TP4BO5MZUC)](https://codecov.io/gh/IlyaMatsuev/Apex-Trigger-Framework)

Simple Apex Trigger Framework wrapped as an unlocked package. Contains the following features:

-   Delegating trigger handlers

-   Exchanging parameters between all handlers

-   Skiping mechanism

-   Configuring trigger error handlers

-   Binding asynchronous trigger handlers (Queueable)

## Overview

To create a trigger handler you first need to implement the `Triggers.IHandler` interface:

```java

public class TestTriggerHandler implements Triggers.IHandler {

    public void handle(Triggers.Context context) {

        // Sample logic

        Integer count = context.stash.containsKey('count') ? (Integer) context.stash.get('count') : 0;

        context.stash.put('count', ++count);

        System.debug('count: ' + count);

    }

}

```

The example of using the framework:

```java

trigger Account on Account (before insert, before update, before delete, after insert, after update, after delete) {

	Triggers.dispatcher

        .bind(TriggerOperation.AFTER_INSERT, new TestTriggerHandler())

        .bind(TriggerOperation.AFTER_UPDATE, new TestTriggerHandler())

        .bindAsync(TriggerOperation.AFTER_DELETE, new TestAsyncTriggerHandler())

        .run();

}

```

First, setup all your handlers by calling `bind()` or `bindAsync()` methods from the `Triggers.dispatcher` instance. After all handlers set you call the `run()` method.

## Installation

You can just install the package by the link on a [sandbox](https://test.salesforce.com/packaging/installPackage.apexp?p0=04t5Y000001wNArQAM) or [dev org](https://login.salesforce.com/packaging/installPackage.apexp?p0=04t5Y000001wNArQAM).

If you prefer using salesforce CLI you can run:

```

sfdx force:package:install -p 04t5Y000001wNArQAM -w 10 -b 10 -u 

```

## Documentation

For more detailed information about the content of the repository and the sfdx package, please visit the [docs folder](docs).

## Questions

If you have any questions you can start a discussion.  

If you think something works not as expected or you want to request a new feature, you can create an issue with the appropriate template selected.

## Contributing

Pull requests are welcome.  

For major changes, please open an issue first to discuss what you would like to change.  

Please make sure to update tests as appropriate.

## License

[MIT](LICENSE)