48 lines
1.6 KiB
Markdown
48 lines
1.6 KiB
Markdown
---
|
|
layout: pattern
|
|
title: Promise
|
|
folder: promise
|
|
permalink: /patterns/promise/
|
|
pumlid: DOqv4i8m301xNW4FYDLJvIl2rYHYBDcZWtmVKr3jDZkxUw15IhyzM6lFHcdzVaPCVm8ONkNWEFELJbQ71ccKEWIuvuKhXJT-S6laVEWsCO9C7GHz2KmRmav0KVzUqgJCtsydROjV
|
|
categories: Concurrency
|
|
tags:
|
|
- Java
|
|
- Functional
|
|
- Reactive
|
|
- Difficulty-Intermediate
|
|
---
|
|
|
|
## Also known as
|
|
CompletableFuture
|
|
|
|
## Intent
|
|
A Promise represents a proxy for a value not necessarily known when the promise is created. It
|
|
allows you to associate dependent promises to an asynchronous action's eventual success value or
|
|
failure reason. Promises are a way to write async code that still appears as though it is executing
|
|
in a synchronous way.
|
|
|
|
|
|
|
|
## Applicability
|
|
Promise pattern is applicable in concurrent programming when some work needs to be done asynchronously
|
|
and:
|
|
|
|
* code maintainability and readability suffers due to callback hell.
|
|
* you need to compose promises and need better error handling for asynchronous tasks.
|
|
* you want to use functional style of programming.
|
|
|
|
|
|
## Real world examples
|
|
|
|
* [java.util.concurrent.CompletableFuture](https://docs.oracle.com/javase/8/docs/api/java/util/concurrent/CompletableFuture.html)
|
|
* [Guava ListenableFuture](https://github.com/google/guava/wiki/ListenableFutureExplained)
|
|
|
|
## Related Patterns
|
|
* Async Method Invocation
|
|
* Callback
|
|
|
|
## Credits
|
|
|
|
* [You are missing the point to Promises](https://gist.github.com/domenic/3889970)
|
|
* [Functional style callbacks using CompletableFuture](https://www.infoq.com/articles/Functional-Style-Callbacks-Using-CompletableFuture)
|