v1.0.0-Alpha33 🦝 🏗️

Note

🦝 Cffu has arrived at v1.0 Alpha series~ 🎉

• Development tries to keep the compatibility for main API.
• The incompatible changes are marked with ⚠️.

Welcome to try out cffu. 💕

💗 Happy with cffu! 🦝 and be a "shifu"~ 😆

☘️ Features

• make more LLCF methods public 🏗️
  • add new method toNonMinCfCopyArray0
• support attachments parameter for handle methods in SwallowedExceptionHandleUtils 🦢
• change swallowed exception logging level to WARN 🦢

🐞 Bug Fixes

• fix(cffu-core): add missing package eh exports directives to module-info.java 📦

🛠 Refactor/Improvements

• ⚠️ rename reset* API methods to with* 🔠 ✨ (suggestion by @linzee1)
  • more conventional method names for unmodifiable/immutable objects, e.g. LocalDate#withDayOfMonth
• ⚠️ rename class, methods and fields in eh package 🦢
• optimize memory usage in allResultsOf* methods 📝
  • does not retain cf results that will never be used
  • reduce redundant writes to results array 🚅 (by @linzee1)
• refactor(eh package): rename and refactor internal method unreferenced 🦢
• use Arrays.setAll of stdlib instead of for loop

📚 Documentation

• improve wording of doc and javadoc 📚💕

🚜 Build/Chore

• chore: fix duplicate dependency warning of maven pom 🤖
• bump org.jetbrains:annotations from 26.0.1 to 26.0.2 (#293)

🔌 API Docs

cffu Java API doc: https://foldright.io/api-docs/cffu/1.0.0-Alpha33/

🍪 Maven dependencies

cffu core lib, including cffu enhancement for Java CompletableFuture:

<dependency>
    <groupId>io.foldright</groupId>
    <artifactId>cffu</artifactId>
    <version>1.0.0-Alpha33</version>
</dependency>

cffu executor wrapper SPI implementation for 📌 TransmittableThreadLocal(TTL):

<dependency>
  <groupId>io.foldright</groupId>
  <artifactId>cffu-ttl-executor-wrapper</artifactId>
  <version>1.0.0-Alpha33</version>
  <scope>runtime</scope>
</dependency>

v1.0.0-Alpha32 🦝 🦢

Note

🦝 Cffu has arrived at v1.0 Alpha series~ 🎉

• Development tries to keep the compatibility for main API.
• The incompatible changes are marked with ⚠️.

Welcome to try out cffu. 💕

💗 Happy with cffu! 🦝 and be a "shifu"~ 😆

☘️ Features

• report the swallowed exceptions by M* methods #263 🦢

🛠 Refactor/Improvements

• ⚠️ remove rarely used API of Cffu, simplify API ⏰
  • remove Cffu#timeout* overloaded methods with parameter executorWhenTimeout
  • if needed, use resetDefaultExecutor method to achieve
• improve log message of swallowed exceptions 🦢
• move class CommonUtils/ExceptionLogger class to package internal 🔧
• ⚠️ change cffu logging system property name to cffu.exception.log.format from cffu.uncaught.exception.log.format

📚 Documentation

• improve wording of doc and javadoc 📚💕

🚜 Build/Chore

• add check_api_docs.sh to CI 📚
• improve bump_cffu_version.sh 🧹

🔌 API Docs

cffu Java API doc: https://foldright.io/api-docs/cffu/1.0.0-Alpha32/

🍪 Maven dependencies

cffu core lib, including cffu enhancement for Java CompletableFuture:

<dependency>
    <groupId>io.foldright</groupId>
    <artifactId>cffu</artifactId>
    <version>1.0.0-Alpha32</version>
</dependency>

cffu executor wrapper SPI implementation for 📌 TransmittableThreadLocal(TTL):

<dependency>
  <groupId>io.foldright</groupId>
  <artifactId>cffu-ttl-executor-wrapper</artifactId>
  <version>1.0.0-Alpha32</version>
  <scope>runtime</scope>
</dependency>

v1.0.0-Alpha31 🦝 🫴

Note

🦝 Cffu has arrived at v1.0 Alpha series~ 🎉

• Development tries to keep the compatibility for main API.
• The incompatible changes are marked with ⚠️.

Welcome to try out cffu. 💕

💗 Happy with cffu! 🦝 and be a "shifu"~ 😆

🐞 Bug Fixes

• fix the wrong exception type check logic of catching* methods 🫴 #291 (by @huhaosumail)

🛠 Refactor/Improvements

• defensive copy input array arguments of thenM* methods 🧵
  • they are used asynchronously NOT thread-safe, and could be mutated by caller
• ⚠️ change cffu logging system property name to cffu.uncaught.exception.log.format from cffu.uncaught.exception.report
  • and rename ExceptionReporter to ExceptionLogger
• do NOT reuse incomplete CF instance in methods bothFailFast0/eitherSuccess0 like fill0 🤖
• add addSuppressed for reportUncaughtException 💣
• extract peek0 methods to LLCF from CFU 🔧
• move completeCf0 method to LLCF class 🔧

📚 Documentation

• improve javadoc of catching* methods

🧪 Tests

• improve test stability

🚜 Build/Chore

• upgrade dependencies/plugins 📦
• move macOS job to fast CI

🔌 API Docs

cffu Java API doc: https://foldright.io/api-docs/cffu/1.0.0-Alpha31/

🍪 Maven dependencies

cffu core lib, including cffu enhancement for Java CompletableFuture:

<dependency>
    <groupId>io.foldright</groupId>
    <artifactId>cffu</artifactId>
    <version>1.0.0-Alpha31</version>
</dependency>

cffu executor wrapper SPI implementation for 📌 TransmittableThreadLocal(TTL):

<dependency>
  <groupId>io.foldright</groupId>
  <artifactId>cffu-ttl-executor-wrapper</artifactId>
  <version>1.0.0-Alpha31</version>
  <scope>runtime</scope>
</dependency>

v1.0.0-Alpha30 🦝 🪑

Note

🦝 Cffu has arrived at v1.0 Alpha series~ 🎉

• Development tries to keep the compatibility for main API.
• The incompatible changes are marked with ⚠️.

Welcome to try out cffu. 💕

💗 Happy with cffu! 🦝 and be a "shifu"~ 😆

🛠 Refactor/Improvements

• ⚠️ adjust executor parameter position, follow the consistent rules: 🪑
  • as first parameter(except cfThis parameter) for varargs methods
    • mSupplyAllSuccessAsync
    • mSupplyMostSuccessAsync
    • mostSuccessResultsOf
    • thenMApplyAllSuccessAsync
    • thenMApplyMostSuccessAsync
  • as last parameter for non-varargs methods
    • cffuOrTimeout
    • cffuCompleteOnTimeout
• change default value of cffu.uncaught.exception.report to full; fail LOUDLY 📢
• refactor(CffuTtlExecutorWrapperProvider): skip wrapping executor if it is marked with TtlEnhanced

📚 Documentation

• add cffuTimeout* guide in README

🧪 Tests

• add CheckExecutorTests 🧵
• move the aspect test to individual package 📦

🚜 Build/Chore

• upgrade dependencies/plugins 🛠️

🔌 API Docs

cffu Java API doc: https://foldright.io/api-docs/cffu/1.0.0-Alpha30/

🍪 Maven dependencies

cffu core lib, including cffu enhancement for Java CompletableFuture:

<dependency>
    <groupId>io.foldright</groupId>
    <artifactId>cffu</artifactId>
    <version>1.0.0-Alpha30</version>
</dependency>

cffu executor wrapper SPI implementation for 📌 TransmittableThreadLocal(TTL):

<dependency>
  <groupId>io.foldright</groupId>
  <artifactId>cffu-ttl-executor-wrapper</artifactId>
  <version>1.0.0-Alpha30</version>
  <scope>runtime</scope>
</dependency>

v1.0.0-Alpha29 🦝 🏗️

Note

🦝 Cffu has arrived at v1.0 Alpha series~ 🎉

• Development tries to keep the compatibility for main API.
• The incompatible changes are marked with ⚠️.

Welcome to try out cffu. 💕

💗 Happy with cffu! 🦝 and be a "shifu"~ 😆

🛠 Refactor/Improvements

• extract LLCF(Low Level CompletableFuture Utils) from CFU 🏗️
• split cffu-listenable-future module from cffu-core 📦
• add @ApiStatus.OverrideOnly for SPI ExecutorWrapperProvider

🚜 Build/Chore

• upgrade dependencies/plugins 🛠️

🔌 API Docs

cffu Java API doc: https://foldright.io/api-docs/cffu/1.0.0-Alpha29/

🍪 Maven dependencies

cffu core lib, including cffu enhancement for Java CompletableFuture:

<dependency>
    <groupId>io.foldright</groupId>
    <artifactId>cffu</artifactId>
    <version>1.0.0-Alpha29</version>
</dependency>

cffu executor wrapper SPI implementation for 📌 TransmittableThreadLocal(TTL):

<dependency>
  <groupId>io.foldright</groupId>
  <artifactId>cffu-ttl-executor-wrapper</artifactId>
  <version>1.0.0-Alpha29</version>
  <scope>runtime</scope>
</dependency>

v1.0.0-Alpha28 🦝 👁️‍🗨️

Note

🦝 Cffu has arrived at v1.0 Alpha series~ 🎉

• Development tries to keep the compatibility for main API.
• The incompatible changes are marked with ⚠️.

Welcome to try out cffu. 💕

💗 Happy with cffu! 🦝 and be a "shifu"~ 😆

🐞 Bug Fixes

• add missing requires directives to module-info.java 📦

🛠 Refactor/Improvements

• refactor(DelayExecutionHelpers.java): review the codes by reference to CompletableFuture, and cleanup  🧹

🧪 Tests

• test(Cffu): add CheckMinStageRuntimeTypeTests for CffuFactory/Cffu 👁️‍🗨️
• test(CI): test usage ThreadPerTaskExecutor as screen executor of CompletableFuture

🚜 Build/Chore

• upgrade dependencies/plugins 🛠️

🔌 API Doc

cffu Java API doc: https://foldright.io/api-docs/cffu/1.0.0-Alpha28/

🍪 Maven dependencies

cffu core lib, including cffu enhancement for Java CompletableFuture:

<dependency>
    <groupId>io.foldright</groupId>
    <artifactId>cffu</artifactId>
    <version>1.0.0-Alpha28</version>
</dependency>

cffu executor wrapper SPI implementation for 📌 TransmittableThreadLocal(TTL):

<dependency>
  <groupId>io.foldright</groupId>
  <artifactId>cffu-ttl-executor-wrapper</artifactId>
  <version>1.0.0-Alpha28</version>
  <scope>runtime</scope>
</dependency>

v1.0.0-Alpha27 🦝 📚

Note

🦝 Cffu has arrived at v1.0 Alpha series~ 🎉

• Development tries to keep the compatibility for main API.
• The incompatible changes are marked with ⚠️.

Welcome to try out cffu. 💕

💗 Happy with cffu! 🦝 and be a "shifu"~ 😆

🛠 Refactor/Improvements

• refactor(CFU): simplify the screenExecutor translation logic, and add Implementation Note 🧵

📚 Documentation

• add LambdaCompilationErrorSolutionOfMultipleActionsMethodsDemo 👨‍🏫
• revise api docs 📚 💕
  • reword and simplify the api docs of M*/thenM* methods, link to their *Of methods
  • add the solution to compilation error caused by lambda arguments 🚨
  • reword the api doc of methods mostSuccessResultsOf
  • add the equivalent Guava method links 💕
    • allFailFastOf -> Futures#whenAllSucceed
    • allOf -> Futures#whenAllComplete

🚜 Build/Chore

• upgrade dependencies/plugins 🛠️

🔌 API Doc

cffu Java API doc: https://foldright.io/api-docs/cffu/1.0.0-Alpha27/

🍪 Maven dependencies

cffu core lib, including cffu enhancement for Java CompletableFuture:

<dependency>
    <groupId>io.foldright</groupId>
    <artifactId>cffu</artifactId>
    <version>1.0.0-Alpha27</version>
</dependency>

cffu executor wrapper SPI implementation for 📌 TransmittableThreadLocal(TTL):

<dependency>
  <groupId>io.foldright</groupId>
  <artifactId>cffu-ttl-executor-wrapper</artifactId>
  <version>1.0.0-Alpha27</version>
  <scope>runtime</scope>
</dependency>

v1.0.0-Alpha26 🦝 💕

Note

🦝 Cffu has arrived at v1.0 Alpha series~ 🎉

• Development tries to keep the compatibility for main API.
• The incompatible changes are marked with ⚠️.

Welcome to try out cffu. 💕

💗 Happy with cffu! 🦝 and be a "shifu"~ 😆

🛠 Refactor/Improvements

• fix(CFU): convert executor for async operations by screenExecutor for timeout* methods, consistent with CF 🧵

🧪 Tests

• add ListenableFutureUsageStudyCaseTest 👨‍🏫

📚 Documentation

revise api docs:

• reword api docs of methods 💕
  • all*Of methods
  • any*Of methods
  • timeout* methods
• fix wrong exception description of AnySuccess methods
• unify term usage
  • use complete normally instead of complete successfully/is successful/do not success, etc.
• remove uninformative/duplicate words
  • duplicate @return to javadoc body, etc
• fix wording, multiply -> multiple 🔠

🚜 Build/Chore

• chore(deps): bump org.jetbrains:annotations from 26.0.0 to 26.0.1 (#262)

🔌 API Doc

cffu Java API doc: https://foldright.io/api-docs/cffu/1.0.0-Alpha26/

🍪 Maven dependencies

cffu core lib, including cffu enhancement for Java CompletableFuture:

<dependency>
    <groupId>io.foldright</groupId>
    <artifactId>cffu</artifactId>
    <version>1.0.0-Alpha26</version>
</dependency>

cffu executor wrapper SPI implementation for 📌 TransmittableThreadLocal(TTL):

<dependency>
  <groupId>io.foldright</groupId>
  <artifactId>cffu-ttl-executor-wrapper</artifactId>
  <version>1.0.0-Alpha26</version>
  <scope>runtime</scope>
</dependency>

v1.0.0-Alpha25 🦝 ⚛️

Note

🦝 Cffu has arrived at v1.0 Alpha series~ 🎉

• Development tries to keep the compatibility for main API.
• The incompatible changes are marked with ⚠️.

Welcome to try out cffu. 💕

💗 Happy with cffu! 🦝 and be a "shifu"~ 😆

☘️ Features

• [cffu-kotlin] add new kotlin extension methods 🍩
  • CompletableFutureExtensions.kt
    • M* extension methods
    • allSuccess* extension methods
    • defaultExecutor extension method
  • CffuExtensions.kt
    • M* extension methods
    • allSuccess* extension methods

🛠 Refactor/Improvements

• ⚠️ rename methods: use term fail fast instead of fast fail ⚛️ (by @linzee1)
• ⚠️ rename Tuple-Multi-Actions(tupleM*) methods 🌟
  • make their naming more consistant with all*Of methods
• fix(CFU): convert executor for async operations by screenExecutor(), consistent with CF 🧵
• refactor(CFU): allResultsFastFailOf/allResultsOf both call internal method allResultsOf0, simpler and more consistent 🌟
• refactor: update generic parameters of methods 🧬
  • join/resultNow methods of CFU
    • add covariance to express the only use as input
  • join/resultNow/orTimeout* methods of CompletableFutureExtensions.kt
    • make orTimeout* generic parameters consistent with CFU
• refactor(CFU): extract internal array util methods into file InternalCommonUtils 🔧
• refactor(CFU): use static initializer instead of one-shot internal method
• refactor(CffuExtensionsTest.kt): extract internal helper methods resolveFac, and add test cases 🔧

🧪 Tests

• test(CFU): improve test cases for write methods of CFU 🧪
• test(CFU): add CheckMinStageRuntimeTypeTests 🧪
  • split MinStageTestUtils.kt from TestUtils.kt

📚 Documentation

• add MultiplyActionsDemo 👨‍🏫
• revise/improve javadoc of peek* methods 📚
• keep api docs of timeout* kotlin extension methods consistent with CFU 📚
• revise README 📚

🚜 Build/Chore

• add update_md_toc.sh to CI
• upgraded non-LTS CI JDK to 23 from 22 🤖
• upgrade dependencies/plugins 🛠️

🔌 API Doc

• cffu Java API doc: https://foldright.io/api-docs/cffu/1.0.0-Alpha25/
• cffu Kotlin API doc: https://foldright.io/api-docs/cffu-kotlin/1.0.0-Alpha25/

🍪 Maven dependencies

cffu core lib, including cffu enhancement for Java CompletableFuture:

<dependency>
    <groupId>io.foldright</groupId>
    <artifactId>cffu</artifactId>
    <version>1.0.0-Alpha25</version>
</dependency>

cffu executor wrapper SPI implementation for 📌 TransmittableThreadLocal(TTL):

<dependency>
  <groupId>io.foldright</groupId>
  <artifactId>cffu-ttl-executor-wrapper</artifactId>
  <version>1.0.0-Alpha25</version>
  <scope>runtime</scope>
</dependency>

v1.0.0-Alpha24 🦝 👓

Note

🦝 Cffu has arrived at v1.0 Alpha series~ 🎉

• Development tries to keep the compatibility for main API.
• The incompatible changes are marked with ⚠️.

Welcome to try out cffu. 💕

💗 Happy with cffu! 🦝 and be a "shifu"~ 😆

🛠 Refactor/Improvements

• use conditional expression instead of if statement when more readable and concise 👓
• improve instance method defaultExecutor
  • rename argument to cfThis
  • ⚠️ change exception to UnsupportedOperationException from IllegalArgumentException
  • add null check for argument
  • revise its javadoc

🧪 Tests

• apply* methods should use Function argument
• simplify test codes by kotlin delegation

📚 Documentation

• revise javadoc of tuple*/allSuccess*/mostSuccess* methods: 📚
  • simplify tuple* methods, just refer to their non-tuple methods
  • add "indistinguishable" note for allSuccess*/mostSuccess* methods

🔌 API Doc

• cffu Java API doc: https://foldright.io/api-docs/cffu/1.0.0-Alpha24/

🍪 Maven dependencies

cffu core lib, including cffu enhancement for Java CompletableFuture:

<dependency>
    <groupId>io.foldright</groupId>
    <artifactId>cffu</artifactId>
    <version>1.0.0-Alpha24</version>
</dependency>

cffu executor wrapper SPI implementation for 📌 TransmittableThreadLocal(TTL):

<dependency>
  <groupId>io.foldright</groupId>
  <artifactId>cffu-ttl-executor-wrapper</artifactId>
  <version>1.0.0-Alpha24</version>
  <scope>runtime</scope>
</dependency>