0Pricing
MCP Academy · Aula

Compartilhar estado pelo contexto do aplicativo

Passe objetos compartilhados para cada manipulador.

Compartilhar estado pelo contexto do aplicativo é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.

Estado de que Todo Manipulador Precisa

As suas ferramentas frequentemente precisam dos mesmos objetos, como um único conjunto de conexões de banco de dados. O ideal é criá-los uma vez e compartilhá-los em todos os lugares.

O Valor Cedido É o Estado

Tudo o que o lifespan cede se torna o estado compartilhado da sua aplicação, disponível para cada ferramenta, recurso e solicitação.

async def lifespan(server):
    yield {"db": db, "cache": cache}

Prefira um Contêiner Tipado

Encapsular o estado em uma dataclass oferece nomes de campos claros e preenchimento automático no editor, em vez de exigir que adivinhe as chaves do dicionário.

@dataclass
class AppContext:
    db: Database

Crie o Estado na Inicialização

Dentro do lifespan, construa cada objeto compartilhado e ceda o contêiner para que ele exista durante toda a execução do servidor.

async def lifespan(server):
    db = await Database.connect()
    yield AppContext(db=db)

Uma Única Fonte de Verdade

O estado compartilhado significa uma única fonte de verdade: cada manipulador vê a mesma conexão, evitando conjuntos de conexões duplicados e com vazamentos.

Não Use Globais

Evite globais no nível do módulo para conexões. Passar o estado pelo contexto mantém as ferramentas testáveis e evita acoplamentos ocultos.

O Estado É do Servidor, Não da Chamada

O contexto da aplicação é criado uma vez na inicialização, não reconstruído a cada solicitação; assim, os seus objetos persistem durante muitas chamadas de ferramentas.

Acesse-o pela Solicitação

Os manipuladores não importam o estado diretamente. Eles recebem um objeto de contexto no momento da chamada, que expõe o valor cedido.

Combine Conexões e Configurações

O seu contêiner compartilhado pode armazenar mais do que clientes: guarde configurações, como URLs base de APIs ou sinalizadores de recursos carregados na inicialização.

@dataclass
class AppContext:
    db: Database
    base_url: str

Mantenha-o Quase Imutável

Trate o estado compartilhado como principalmente somente leitura. Alterá-lo em muitas chamadas simultâneas convida a erros sutis e difíceis de rastrear.

O Lifespan Controla o Ciclo de Vida

Como o lifespan cria o estado, ele também assume a responsabilidade por desmontá-lo, mantendo a criação e a limpeza em um único lugar organizado.

Verificação Rápida

O que se torna o estado compartilhado da aplicação que os seus manipuladores podem usar?

Recapitulação: Compartilhando o Estado

Você cria os objetos compartilhados uma vez no lifespan, cede um contêiner tipado e permite que cada manipulador o leia. A seguir: como acessá-lo. 🧩

Perguntas Frequentes

A aula “Compartilhar estado pelo contexto do aplicativo” é grátis?

Sim — o texto completo de “Compartilhar estado pelo contexto do aplicativo” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.

O que vou aprender em “Compartilhar estado pelo contexto do aplicativo”?

Passe objetos compartilhados para cada manipulador. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar MCP Academy?

Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “Compartilhar estado pelo contexto do aplicativo”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de MCP Academy?

Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. O gancho de inicialização do ciclo de vida
  2. Compartilhar estado pelo contexto do aplicativo
  3. Acessar o objeto de contexto
  4. Encerramento limpo e liberação de recursos
← Voltar para MCP Academy