Releases: smsaero/smsaero_java
Releases · smsaero/smsaero_java
Release list
3.3.0
v3.2.0
Release Notes: v3.2.0
What's New
Test Mode
EnableTestMode()— Switch to test endpoints (sms/testsend,sms/teststatus,sms/testlist). No real SMS are sent and no charges apply.DisableTestMode()— Switch back to production mode.IsTestModeActive()— Check whether test mode is enabled.
Useful for development and debugging without affecting your account balance.
Command-Line Interface (CLI)
- New fat JAR artifact:
smsaero-3.2.0-cli.jarwithru.smsaero.CommandLineas main class. - Send SMS from the command line:
java -jar smsaero-3.2.0-cli.jar --email YOUR_EMAIL --api_key YOUR_API_KEY --phone 70000000000 --message "Hello" - Supports environment variables:
SMSAERO_EMAIL,SMSAERO_API_KEY,SMSAERO_PHONE,SMSAERO_MESSAGE,SMSAERO_SIGN. - Options:
--sign(sender signature),--debug(test mode).
Docker Support
- Official Docker image:
smsaero/smsaero_java:latest - Run CLI in a container:
docker run --rm smsaero/smsaero_java:latest --email YOUR_EMAIL --api_key YOUR_API_KEY --phone 70000000000 --message "Hello"
CI/CD
- GitLab CI pipeline with stages: test, compat, build.
- Compatibility matrix: Java 11, 17, 21, 25.
Core Library Improvements
- Thread safety — Instance fields are now thread-local where needed; client is safe for concurrent use.
- Retry logic — Automatic retry on transient network errors (timeouts, connection refused, etc.).
- Validation — Constructor validates
emailandapiKey(non-null, non-blank); throwsIllegalArgumentExceptionon invalid input. - Timeouts — Configurable connect (10s) and read (30s) timeouts.
- Javadoc — Added documentation for public API.
Documentation
- README updated with Maven Central badge, API docs link, and usage examples.
- Russian documentation:
README.RUS.md. - Note: Java 8 users should stay on v3.1.0.
Testing
- New unit tests in
SmsAeroTest.java(JUnit 5).
Breaking Changes
- Minimum Java version: 11 — Java 8 is no longer supported. Use v3.1.0 for Java 8 projects.
Migration from v3.1.0
- Update Maven/Gradle dependency to
3.2.0. - Ensure your project uses Java 11+.
- No API changes for existing
SmsAerousage; new methods (EnableTestMode, etc.) are additive.