File: AssertIfClient.java

package info (click to toggle)
checker-framework-java 3.2.0%2Bds-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 23,104 kB
  • sloc: java: 145,916; xml: 839; sh: 518; makefile: 404; perl: 26
file content (60 lines) | stat: -rw-r--r-- 1,904 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
import org.checkerframework.checker.nullness.qual.*;
import org.checkerframework.dataflow.qual.*;

public class AssertIfClient {

    @RequiresNonNull("#1.rpcResponse()")
    void rpcResponseNonNull(Proxy proxy) {
        @NonNull Object response = proxy.rpcResponse();
    }

    void rpcResponseNullable(Proxy proxy) {
        @Nullable Object response = proxy.rpcResponse();
    }

    void rpcResponseTypestate() {
        Proxy proxy = new Proxy();
        // :: error: (assignment.type.incompatible)
        @NonNull Object response1 = proxy.rpcResponse();
        // :: error: (contracts.precondition.not.satisfied)
        rpcResponseNonNull(proxy);
        rpcResponseNullable(proxy);

        proxy.issueRpc();
        @NonNull Object response2 = proxy.rpcResponse();
        @NonNull Object response3 = proxy.rpcResponse();
        rpcResponseNonNull(proxy);
        rpcResponseNullable(proxy);
    }
}

class Proxy {

    // the RPC response, or null if not yet received
    @MonotonicNonNull Object response = null;

    @SuppressWarnings("contracts.postcondition.not.satisfied")
    @EnsuresNonNull({"response", "rpcResponse()"})
    void issueRpc() {
        response = new Object();
    }

    // If this method returns true,
    // then response is non-null and rpcResponse() returns non-null
    @SuppressWarnings("contracts.conditional.postcondition.not.satisfied")
    @EnsuresNonNullIf(
            expression = {"response", "rpcResponse()"},
            result = true)
    boolean rpcResponseReceived() {
        return response != null;
    }

    // Returns non-null if the response has been received, null otherwise;
    // but an @AssertNonNullIfNonNull annotation would states the converse,
    // that if the result is non-null then the response hs been received.
    // See rpcResponseReceived.
    @Pure
    @Nullable Object rpcResponse() {
        return response;
    }
}