# General Translation Python SDKs: StorageAdapter
URL: https://generaltranslation.com/it/docs/python/reference/classes/storage-adapter.mdx
---

title: StorageAdapter
description: Classe base astratta per la memorizzazione dell'impostazione regionale per richiesta in General Translation Python. Riferimento API per StorageAdapter.

---

La classe base astratta per gli adattatori che memorizzano e leggono l'impostazione regionale per richiesta. Derivane una sottoclasse per controllare dove viene conservata l'impostazione regionale corrente (ad esempio, nel request context di un framework). L'implementazione predefinita è [`ContextVarStorageAdapter`](/docs/python/reference/classes/context-var-storage-adapter).

## Panoramica [#overview]

`StorageAdapter` è una [classe base astratta](https://docs.python.org/3/library/abc.html) (estende `abc.ABC`). Definisce due metodi astratti che devi implementare; non è possibile istanziarla direttamente.

```python
from gt_i18n import StorageAdapter

class MyAdapter(StorageAdapter):
    def get_item(self, key: str) -> str | None:
        ...

    def set_item(self, key: str, value: str) -> None:
        ...
```

Importa `StorageAdapter` da `gt_i18n`. Non è riesportato dai pacchetti del framework.

## Come funziona [#how-it-works]

* **Metodi astratti.** `get_item` e `set_item` sono astratti; una sottoclasse deve implementarli entrambi.
* **Chiave dell'impostazione regionale.** Il manager legge e scrive l'impostazione regionale con la chiave `"locale"`. Un adattatore può ignorare le altre chiavi.
* **Integrazione.** Passa un adattatore personalizzato come `store_adapter` a [`I18nManager`](/docs/python/reference/classes/i18n-manager).

## Metodi [#members]

| Metodo                         | Descrizione                                         | Restituisce   |
| ------------------------------ | --------------------------------------------------- | ------------- |
| [`get_item`](#member-get-item) | Recupera un valore memorizzato in base alla chiave. | `str \| None` |
| [`set_item`](#member-set-item) | Memorizza un valore in base alla chiave.            | `None`        |

### `get_item(key)` [#member-get-item]

**Astratto.** Restituisce il valore memorizzato per `key`, oppure `None` se non è presente.

### `set_item(key, value)` [#member-set-item]

**Astratto.** Memorizza `value` con la chiave `key`.

## Esempio [#example]

```python
from gt_i18n import StorageAdapter, I18nManager

class DictStorageAdapter(StorageAdapter):
    def __init__(self) -> None:
        self._data: dict[str, str] = {}

    def get_item(self, key: str) -> str | None:
        return self._data.get(key)

    def set_item(self, key: str, value: str) -> None:
        self._data[key] = value

manager = I18nManager(default_locale="en", store_adapter=DictStorageAdapter())
```