|
imodule 1.0.0
The contract every loadable module answers to
|
Une ligne par contrat, une colonne par origine. More...
#include <IModuleManager.hpp>
Public Types | |
| using | Span = typename Stride< IModule * >::Span |
| Une ligne ou une colonne de la table. Contient les cases vides. | |
Public Member Functions | |
| ~IModuleManager () | |
| bool | Load (const std::string &path, const std::string &key) |
| Ouvre une bibliotheque et ajoute les modules qu'elle exporte. | |
| bool | add (const std::string &key, std::vector< std::unique_ptr< IModule > > modules) |
| Ajoute une colonne sans bibliotheque. Le manager prend possession des modules. | |
| bool | add (const std::string &key, std::unique_ptr< IModule > module) |
| Comme add(key, vector<...>), pour un seul module. | |
| IModule * | Get (const std::string &type, const std::string &key) |
| Une case : ce contrat, chez ce fournisseur. | |
| Span | GetAllByType (const std::string &type) |
| La ligne : une case par fournisseur, pour ce contrat. | |
| Span | GetAllByKey (const std::string &key) |
| La colonne : une case par contrat, pour ce fournisseur. | |
| Span | GetAll () |
| Toute la table, cases vides comprises. | |
| bool | acquire (IModule *module) |
| Declarer un detenteur de plus sur ce module. | |
| void | release (IModule *module) |
| Un detenteur de moins. Libere ses claims() au dernier. | |
| void | Unload (const std::string &key) |
| Condamne une colonne : ses detenteurs doivent lacher. | |
| size_t | Reconcile () |
| Ferme les colonnes condamnees que plus personne ne tient. | |
| template<typename T > | |
| T * | Get (const std::string &key) |
| Ce contrat chez ce fournisseur, avec son vrai type. | |
| template<typename T > | |
| std::vector< T * > | GetAllByType () |
| Tous ceux qui remplissent ce contrat, avec leur vrai type. | |
| const std::vector< std::string > & | GetTypes () const |
| Les contrats presents, dans l'ordre de decouverte. | |
| const std::vector< std::string > & | GetKeys () const |
| Les origines chargees, dans l'ordre d'arrivee. | |
Static Public Attributes | |
| static constexpr const char * | entry = "getModules" |
| Le seul symbole qu'une bibliotheque doit exporter. | |
Une ligne par contrat, une colonne par origine.
| raylib | sfml | asio -----------|--------------------|-------------------|------------------- graphic | RayGraphicModule | SfmlGraphicModule | audio | RayAudioModule | SfmlAudioModule | network | | | AsioNetworkModule
Une colonne vient d'une bibliotheque (Load()) ou de l'hote lui-meme (add()). Elle se lit par contrat, par origine, ou case par case.
Aucun choix n'est impose : chaque invite lit la table et tente d'acquerir ce qu'il veut. La seule chose qui puisse le refuser est une ressource materielle deja prise (IModule::claims()).
C'est ce que bind() pose sur chaque module : de la ou il est, un module peut trouver ses voisins, jamais fermer une bibliotheque.
| using IModuleManager::Span = typename Stride<IModule *>::Span |
Une ligne ou une colonne de la table. Contient les cases vides.
|
inline |
|
inline |
Declarer un detenteur de plus sur ce module.
| module |
|
inline |
Comme add(key, vector<...>), pour un seul module.
|
inline |
Ajoute une colonne sans bibliotheque. Le manager prend possession des modules.
Pour un module compile dans l'hote. L'appelant lache son unique_ptr : il ne peut plus le detruire lui-meme.
| key | le nom de la colonne |
| modules | au moins un |
|
inline |
Ce contrat chez ce fournisseur, avec son vrai type.
Parcourt T::accepts : demander un IGraphic2Module trouve aussi un vendor qui ne declare que "graphic3".
| key |
|
inline |
Une case : ce contrat, chez ce fournisseur.
| type | |
| key |
|
inline |
Toute la table, cases vides comprises.
|
inline |
La colonne : une case par contrat, pour ce fournisseur.
Les contrats qu'il ne remplit pas rendent nullptr.
| key |
|
inline |
Tous ceux qui remplissent ce contrat, avec leur vrai type.
Rend un vecteur, et non un Span : plusieurs lignes (T::accepts) sont agregees en une.
|
inline |
La ligne : une case par fournisseur, pour ce contrat.
Les fournisseurs qui ne le remplissent pas rendent nullptr.
for (IModule *m : modules.GetAllByType("graphic2"))
if (m && m->acquire()) { ...; break; }
| type |
|
inline |
Les origines chargees, dans l'ordre d'arrivee.
|
inline |
Les contrats presents, dans l'ordre de decouverte.
|
inline |
Ouvre une bibliotheque et ajoute les modules qu'elle exporte.
| path | |
| key | le nom de la colonne |
|
inline |
Ferme les colonnes condamnees que plus personne ne tient.
A appeler a chaque tick. Une colonne encore tenue est laissee telle quelle : on repassera.
|
inline |
Un detenteur de moins. Libere ses claims() au dernier.
| module |
|
inline |
Condamne une colonne : ses detenteurs doivent lacher.
Ne ferme rien. Tout ce que ces modules ont fabrique reste valide jusqu'a Reconcile().
| key |
|
staticconstexpr |
Le seul symbole qu'une bibliotheque doit exporter.
Un IModule ** termine par nullptr : deux pointeurs traversent un dlopen sans rien supposer de l'ABI d'en face.