`DefaultOpenShiftClient` implementa entrambe le interfacce `KubernetesClient` e `OpenShiftClient`, quindi se hai bisogno
delle estensioni OpenShift, come i `Build`s, ecc., allora basta fare:```java
OpenShiftClient osClient = new DefaultOpenShiftClient();

L'uso del DSL è lo stesso per tutte le risorse.

Elenca le risorse:```java
NamespaceList myNs = client.namespaces().list();

ServiceList myServices = client.services().list();

ServiceList myNsServices = client.services().inNamespace("default").list();

Elimina:```java
Namespace myns = client.namespaces().withName("myns").delete();

Service myservice = client.services().inNamespace("default").withName("myservice").delete();

Nello stesso spirito puoi inserire i builder inline per creare:```java
Namespace myns = client.namespaces().create(new NamespaceBuilder()
                   .withNewMetadata()
                     .withName("myns")
                     .addToLabels("a", "label")
                   .endMetadata()
                   .build());

Service myservice = client.services().inNamespace("default").create(new ServiceBuilder()
                     .withNewMetadata()
                       .withName("myservice")
                       .addToLabels("another", "label")
                     .endMetadata()
                     .build());

### Seguire gli eventi

Usa `io.fabric8.kubernetes.api.model.Event` come T per Watcher:```java
client.events().inAnyNamespace().watch(new Watcher<Event>() {

  @Override
  public void eventReceived(Action action, Event resource) {
    System.out.println("event " + action.name() + " " + resource.toString());
  }

  @Override
  public void onClose(KubernetesClientException cause) {
    System.out.println("Watcher close due to " + cause);
  }

});

### Caricamento di risorse da fonti esterne

Ci sono casi in cui si desidera leggere una risorsa da una fonte esterna, piuttosto che definirla utilizzando il DSL dei client.
In questi casi il client consente di caricare la risorsa da:

- Un file *(Supporta sia java.io.File che java.lang.String)*
- Un URL
- Un flusso di input

Una volta caricata la risorsa, puoi trattarla come se l'avessi creata tu stesso.

Ad esempio, leggiamo un pod da un file yml e lavoriamoci:

    Pod refreshed = client.load('/path/to/a/pod.yml').fromServer().get();
    Boolean deleted = client.load('/workspace/pod.yml').delete();
    LogWatch handle = client.load('/workspace/pod.yml').watchLog(System.out);

### Passaggio di un riferimento di una risorsa al client

Nello stesso spirito puoi utilizzare un oggetto creato esternamente (sia un riferimento che la sua rappresentazione testuale).

Ad esempio:

    Pod pod = someThirdPartyCodeThatCreatesAPod();
    Boolean deleted = client.resource(pod).delete();

### Adattamento del client

Il client supporta adattatori collegabili. Un esempio di adattatore è l'[OpenShift Adapter](https://github.com/shoucheng3/fabric8io__kubernetes-client_cve-2021-4178_5-0-2/blob/HEAD/openshift-client/src/main/java/io/fabric8/openshift/client/OpenShiftExtensionAdapter.java)
che consente di adattare un'istanza esistente di [KubernetesClient](https://github.com/shoucheng3/fabric8io__kubernetes-client_cve-2021-4178_5-0-2/blob/HEAD/kubernetes-client/src/main/java/io/fabric8/kubernetes/client/KubernetesClient.java) a un [OpenShiftClient](https://github.com/shoucheng3/fabric8io__kubernetes-client_cve-2021-4178_5-0-2/blob/HEAD/openshift-client/src/main/java/io/fabric8/openshift/client/OpenShiftClient.java).

 Ad esempio:```java
KubernetesClient client = new DefaultKubernetesClient();

OpenShiftClient oClient = client.adapt(OpenShiftClient.class);

#### Adattamento e chiusura
Nota: quando si usa adapt(), sia l'adaptee che il target condividono le stesse risorse (client http sottostante, pool di thread, ecc.).
Ciò significa che non è necessario chiamare close() su ogni singola istanza creata tramite adapt.
Chiamare close() su una qualsiasi delle istanze gestite da adapt() o sull'istanza originale pulirà correttamente tutte le risorse e quindi nessuna delle istanze sarà più utilizzabile.


## Simulare Kubernetes

Oltre al client, questo progetto fornisce anche un server mock di kubernetes che puoi utilizzare per scopi di test.
Il server mock si basa su `https://github.com/square/okhttp/tree/master/mockwebserver` ma è potenziato dal DSL e dalle funzionalità fornite da `https://github.com/fabric8io/mockwebserver`.

Il Mock Web Server ha due modalità di funzionamento:

- Modalità Expectations
- Modalità CRUD

### Modalità Expectations

È la modalità tipica in cui prima si impostano quali sono le richieste http attese e quali dovrebbero essere le risposte per ciascuna richiesta.
Maggiori dettagli sull'utilizzo sono disponibili all'indirizzo: https://github.com/fabric8io/mockwebserver

Questa modalità è stata ampiamente utilizzata per testare il client stesso. Assicurati di controllare [kubernetes-test](https://github.com/shoucheng3/fabric8io__kubernetes-client_cve-2021-4178_5-0-2/blob/HEAD/kubernetes-tests/src/test/java/io/fabric8/kubernetes/client/mock).

Per aggiungere un server Kubernetes al tuo test:```java
@Rule
public KubernetesServer server = new KubernetesServer();

Poi puoi usare il server così:```java
@Test
public void testInCrudMode() {
    KubernetesClient client = server.getClient();
    final CountDownLatch deleteLatch = new CountDownLatch(1);
    final CountDownLatch closeLatch = new CountDownLatch(1);

    //CREATE
    client.pods().inNamespace("ns1").create(new PodBuilder().withNewMetadata().withName("pod1").endMetadata().build());

    //READ
    podList = client.pods().inNamespace("ns1").list();
    assertNotNull(podList);
    assertEquals(1, podList.getItems().size());

    //WATCH
    Watch watch = client.pods().inNamespace("ns1").withName("pod1").watch(new Watcher<Pod>() {
        @Override
        public void eventReceived(Action action, Pod resource) {
            switch (action) {
                case DELETED:
                    deleteLatch.countDown();
                    break;
                default:
                    throw new AssertionFailedError(action.toString().concat(" isn't recognised."));
            }
        }

        @Override
        public void onClose(KubernetesClientException cause) {
            closeLatch.countDown();
        }
    });

    //DELETE
    client.pods().inNamespace("ns1").withName("pod1").delete();

    //READ AGAIN
    podList = client.pods().inNamespace("ns1").list();
    assertNotNull(podList);
    assertEquals(0, podList.getItems().size());

    assertTrue(deleteLatch.await(1, TimeUnit.MINUTES));
    watch.close();
    assertTrue(closeLatch.await(1, TimeUnit.MINUTES));
}

KubernetesClient client;

@Test
public void testInStandardMode() {
        ...
}

Nel caso in cui desideri definire un'istanza statica del server mockato per tutti i test (JUnit4 `@ClassRule`), devi dichiarare un'istanza di `KubernetesClient` come mostrato di seguito.
Puoi anche abilitare crudMode utilizzando il campo dell'annotazione `crud`.```java
@EnableKubernetesMockClient(crud = true)
class ExampleTest {

    static KubernetesClient client;

    @Test
    public void testInCrudMode() {
            ...
    }
}