Welcome to the wonderful world of functional programming inspired by Java Optionals (https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Optional.html#ifPresent(java.util.function.Consumer). This module will make your life very happy ๐ and ๐ accelerate your functional processes as you will never have to deal with null values ever again.
An cbOptional
is a simple functional class that wraps a value which can exist or be null. Then you can use all the functions to interact/retrieve or do all kinds of operations on the value. Let's visit a simple example of retrieving an item from a cache, which can produce nulls:
// How many times have we had to do this? Very imperative.
var results = cache.get( "my-key" );
if( isNull( results ) ){
// do something
} else{
// use it.
}
As you can see above, the code is very imperative, retrieving the results from the cache and acting upon its existence. Now, let's use an optional:
return cache
.get( "my-key" )
.orElse( "default" );
cache
.get( "my-key" )
.ifPresent( function( value ){
// Do somethign with the value
})
.orElseGet( function(){
return // something else with the value
});
You will need to retrieve optionals using WireBox via it's injection DSL: @cbOptional
. Or you can use a full new cbOptional.models.cbOptional()
if not in ColdBox mode.
getInstance( "@cbOptional" );
There are many methods to create optionals:
init()
- An empty optionalinit( value )
- Seed an optional with a valueempty()
- Return an empty optionalof( value )
- Return an optional of the passed NON null valueofNullable( value )
- Return an optional of the passed existent or possible null value
The following methods are for testing the existence of a value in the optional
isPresent()
- true if the value is setisEmpty()
- false if the value is NOT setisEqual( optional )
- Tests if the passed optional's value is the same as the optional value called. If both are empty, this is true
You can also do actions and return different values if needed
ifPresent( consumer )
- If the value is set, theconsumer
closure or lambda is called for you with a single argument, the value.ifPresentOrElse( consumer, runnable )
- If the value is set, theconsumer
closure or labmda is called, else therunnable
closure/lambda is called.filter( predicate )
- If a value is present and the value matches the given predicate closure/lambda, the optional with that value is returned or an empty optionalmap( mapper )
- If a value is present, it will be passed through the mapper function/closure and a new optional with the return value of the mapper will be returned.get()
- Retrieve the value or an exception if it doesn't exist.orElse( other )
- Return the value if present, otherwise returnother
.orElseRun( runnable )
- If the value is NOT present, then run therunnable
closure or labmda.orElseGet( supplier )
- Return the value if present, otherwise invokesupplier
and return the result of that invocation.or( supplier ), $or( supplier )
- If a value is present, returns an Optional describing the value, otherwise returns an Optional produced by the supplying function.orElseThrow( type, message )
- If a value is present, returns the value, otherwise throwsNoSuchElementException
or your own type and message.
hashCode()
- Returns the hash code value of the present value, if any, or 0 (zero) if no value is present.toString()
- Returns a non-empty string representation of this Optional suitable for debugging.
Copyright Since 2005 ColdBox Framework by Luis Majano and Ortus Solutions, Corp www.ortussolutions.com
Because of His grace, this project exists. If you don't like this, then don't read it, its not for you.
"Therefore being justified by faith, we have peace with God through our Lord Jesus Christ: By whom also we have access by faith into this grace wherein we stand, and rejoice in hope of the glory of God. And not only so, but we glory in tribulations also: knowing that tribulation worketh patience; And patience, experience; and experience, hope: And hope maketh not ashamed; because the love of God is shed abroad in our hearts by the Holy Ghost which is given unto us. ." Romans 5:5
"I am the way, and the truth, and the life; no one comes to the Father, but by me (JESUS)" Jn 14:1-12