This release includes improvements to the standard library APIs. The full list of APIs has been reviewed and enhancements incorporated with the intention of making the API usage simpler to the developer.
For example, the Request
parameter has been made optional in the signatures of the HTTP client functions for standard HTTP methods. This makes the usage much simpler for developers.
http:Request req = new;
var clientResponse = clientEP->get("/echo"); // Passing a request is optional
var clientResponse = clientEP->get("/echo", request = req);
Another example of the API refactoring from HTTP package is the merge of both Client
and SimpleClient into a single endpoint called Client
.
The simplified use of a sample of FailoverClient
configuration now looks like:
endpoint http:FailoverClient ClientEP {
timeoutMillis:5000,
failoverCodes:[501, 502, 503],
intervalMillis:5000,
targets:[
{
url:"http://localhost:3000/mock1"
},
{
url:"http://localhost:8080/echo",
secureSocket:{
trustStore:{
filePath:"${ballerina.home}/bre/security/ballerinaTruststore.p12",
password:"ballerina"
},
verifyHostname:false,
shareSession:true
}
},
{
url:"http://localhost:8080/mock2"
}
]
};
A sample of Client
configuration:
endpoint http:Client clientEP {
url:"http://localhost:8080/mock",
timeoutMillis:5000
};
Numerous similar refactoring have been done across the standard library API and you can find further details by referring latest API documentation.
Compiled version of a Ballerina package support, in short form referred to as “balo” in developer community, has been added to this release. When packages are built into a .balo, they will be installed into the project repository.
ballerina build -c <package> [-o <output-file>.balo]
This release ships many stabilization enhancements to the type system elements that were introduced in 0.970.0-beta0. All other parts of the language implementation have been stabilized with many fixes.
You will have to update the API usage in sync with the API enhancements. Please use the latest API documentation to explore the latest API.
- Standard library API enhancements and refactoring
- Compiled version of a Ballerina package (balo) support
You can download the Ballerina distributions, try samples, and read the documentation at https://ballerina.io. You can also visit Quick Tour to get started. We encourage you to report issues, improvements, and suggestions at Ballerina Github Repository.