vault backup: 2025-03-04 11:17:00

This commit is contained in:
2025-03-04 11:17:00 +08:00
parent d1e51bfd2f
commit ff12c4f4ca
161 changed files with 1 additions and 2 deletions

View File

@@ -0,0 +1,61 @@
[AtomicBoolean  |  Android Developers](https://developer.android.com/reference/java/util/concurrent/atomic/AtomicBoolean)
## 初始化
```kotlin
val init = AtomicBoolean(false)
or
val inti = AtomicBoolean() // Default false
```
## read/write
`get()`取值,用`set()`設值
例:
```kotlin
if (init.get()) { ... } // 如果 init 是 true 的話
init.set(true) // 將 init 設為 true
```
## 其他function
### compareAndExchange
- [compareAndExchange](https://developer.android.com/reference/java/util/concurrent/atomic/AtomicBoolean#compareAndExchange(boolean,%20boolean))
```java
public final boolean compareAndExchange (
boolean expectedValue,
boolean newValue)
```
如果目前的值跟`expectedValue`相等,回傳目前值,並將目前值設為`newValue`
如果目前的值跟`expectedValue`不相等,回傳目前值,不做任何設定。
### compareAndSet
- [compareAndSet](https://developer.android.com/reference/java/util/concurrent/atomic/AtomicBoolean#compareAndSet(boolean,%20boolean))
```java
public final boolean compareAndSet (
boolean expectedValue,
boolean newValue)
```
如果目前的值跟`expectedValue`相等return `true`,並將目前值設為`newValue`
如果目前的值跟`expectedValue`不相等return `false`
## 用途
一般而言,`set``get` 已經夠用,但如果需要讀值並設定一個新值的話,那就需要 `compareAndSet` 或是 `compareAndExchange`,不然就需要另一個 `mutex` 來達到同樣效果。
假設一個情況,假設目前是 `false` 的情況下,我們可以存取某些資源,所以也要把值設為 `true`,用 `mutex` 的作法如下:
```kotlin
mutex.lock()
if (useable.get()) {
useable.set(false)
// Do something
} else {
...
}
mutex.unlock()
```
改用 `compareAndSet` 就是:
```kotlin
if (useable.compareAndSet(false, true)) {
// Do something
}
```
## 資料
- [java - compareandexchange() vs compareandset() of Atomic-Integer - Stack Overflow](https://stackoverflow.com/questions/60648557/compareandexchange-vs-compareandset-of-atomic-integer)

View File

@@ -0,0 +1,62 @@
## 最簡單 class 定義
Kotlin 中的 class 由 `class` 關鍵字開始一個簡單的class如下
```kotlin
class VerySimple {
}
```
如果需要 constructor 的話,則在 class 名稱之後加入所需的參數,如下:
```kotlin
class VerySimple(val para1: Int, val para2: String ) {
}
```
加在 constructor 中的參數會自動變成 class 的「成員變數」,如果在參數前面加上 `private`,則會成「私有成員變數」,也就是無法被外部所存取。
## 多個 constructor
前面所的 constructor 是建立class 的「主要constructor」kotlin 也允許建立其他 constructor但是這些「次要constructor」都必須呼叫「主要constructor」來進行初始化如下
```kotlin
class VerySimple(val para1: Int, val para2: String ) {
constructor(val para1: Int): this(para1, para2="someText") // 第一個「次要constructor」
constructor(val para2: String): this(para1=123, para2) // 第二個「次要constructor」
}
```
不管是第一個「次要constructor」或是第二個「次要constructor」都必須呼叫主要的`(val para1: Int, val para2: String )`這一個「主要constructor」。
如果有邏輯上的需求「次要constructor」也可以加上邏輯判斷區塊如下
```kotlin
class VerySimple(val para1: Int, val para2: String ) {
constructor(val para1: Int): this(para1, para2="someText") // 第一個「次要constructor」
constructor(val para2: String): this(para1=123, para2) { // 第二個「次要constructor」
if (para2 == "error") {
println("Something wrong")
para1 = 25 // 這行會錯誤因為para1是被宣告成val而不是var
}
}
}
```
## `init` 區塊
`init`是個優先權高於「主要constructor」的執行區塊如下
```kotlin
class VerySimple(val para1: Int, val para2: String ) {
init {
require(para1 > 0, {"para1 must larger than 0"})
require(para2.isNotBlank(), {"para2 cannot be a empty string"})
}
constructor(val para1: Int): this(para1, para2="someText") // 第一個「次要constructor」
constructor(val para2: String): this(para1=123, para2) { // 第二個「次要constructor」
if (para2 == "error") {
println("Something wrong")
para1 = 25 // 這行會錯誤因為para1是被宣告成val而不是var
}
}
}
```
`init`區塊會在初始化之前進行檢查,如果不符合條件,則會丟出`IllegalArgumentException`異常。

View File

@@ -0,0 +1,80 @@
`run`, `let`, `with`, `also``apply` 這幾個都是可以搭配 object 使用的函數,它們之間的差異不大,主要是讓程式在語意上更加流暢。
以下解釋各個的差別。
## 歸納
| | 變數名稱 | 自訂變數名稱 | 回傳 |
|:--------------:|:----------:|:------------:|:--------:|
| `run()` | | | 最後一行 |
| `with()` | `this` | No | 最後一行 |
| `object.run` | `this` | No | 最後一行 |
| `object.let` | `it` | Yes | 最後一行 |
| `object.also` | `it` | Yes | `this` |
| `object.apply` | `this` | No | `this` |
## run
`run` 後面的區塊會**回傳「最後一行」**,所以可以進行「串接」。如下:
```kotlin
run {
val telephone = Telephone()
telephone.whoCallMe = "English"
telephone // <-- telephone 被帶到下一個 Chain
}.callMe("Softest part of heart") // <-- 這裡可以執行 `Telephone` Class 的方法
```
## object.run
`object.run` 跟[[#run]]是一樣的,也是**回傳「最後一行」**,只是 `object.run` 是讓 object 呼叫的,而且 lambda scope 中的物件會變成 `this``this` 可以省略,但是不可以自訂變數名稱,如下:
```kotlin
val anObject = MyObject()
anObject.run {
this.doSomething() // this就是anObjectthis可以省略
}
```
## with
`with(T)` 之中的傳入值可以以 `this` (稱作 identifier) 在 scope 中取用,不用打出 `this`也沒關係。雖然, `with` 也會**將最後一行回傳**。但是因為 `with` 沒有先判斷物件是否為 `null`,所以 scope 中還是要用`?`來判斷是否 `null`,如下:
```kotlin
val anObject = makeMyObject() // anObject有可能是null
with(anObject) {
this?.doSomething() // this就是anObjectthis可能是null
}
```
## object.let
`let` 的 scope 裡,物件是 `it`,可以自訂變數名稱,一樣會**回傳最後一行**。如下:
```kotlin
val anObject = makeMyObject()
anObject?.let { // anObject有可能是null所以要先用?判斷
it.doSomething() // it就是anObject在scope內一定不是null
}
```
## object.also
`also` 的 scope 裡,物件是 `it`,可以自訂變數名稱,但是不是回傳最後一行,是**回傳自己**(也就是 `it`)。如下:
```kotlin
val anObject = makeMyObject()
anObject?.also { // anObject有可能是null所以要先用?判斷
it.doSomething() // it就是anObject在scope內一定不是null
}.also {
it.doSomething2() // it就是anObject
}.also {
it.doSomething3() // it就是anObject
}
```
## object.apply
`apply` 的 scope 裡,物件是 `this`,不可以自訂變數名稱,但是不是回傳最後一行,是**回傳自己**(也就是 `this`)。如下:
```kotlin
val anObject = makeMyObject()
anObject?.also { // anObject有可能是null所以要先用?判斷
this.doSomething() // this就是anObject在scope內一定不是null
}.also {
this.doSomething2() // this就是anObject
}.also {
this.doSomething3() // this就是anObject
}
```
## 參考
- [簡介 Kotlin: run, let, with, also 和 apply](https://louis383.medium.com/%E7%B0%A1%E4%BB%8B-kotlin-run-let-with-also-%E5%92%8C-apply-f83860207a0c)
- [Kotlin 的 scope function: apply, let, run..等等](https://jchu.cc/2018/05/05-kotlin.html)
- [Kotlin 線上讀書會 筆記 (五) apply、let、run、with、also和takeIf](https://medium.com/evan-android-note/kotlin-%E7%B7%9A%E4%B8%8A%E8%AE%80%E6%9B%B8%E6%9C%83-%E7%AD%86%E8%A8%98-%E4%BA%94-apply-let-run-with-also%E5%92%8Ctakeif-2c09d42b09b5)