anl 26.107.0 → 26.107.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ar.md +59 -59
- package/README.es.md +59 -59
- package/README.fr.md +106 -106
- package/README.jp.md +56 -56
- package/README.md +131 -67
- package/README.ru.md +56 -56
- package/README.zh.md +144 -78
- package/lib/package.json.js +1 -1
- package/lib/src/build-type/core/get-data.js +1 -1
- package/lib/src/build-type/core/path.js +1 -1
- package/lib/src/build-type/index.js +1 -1
- package/package.json +1 -1
package/README.fr.md
CHANGED
|
@@ -113,11 +113,11 @@ $ anl type
|
|
|
113
113
|
"indentation": "\t",
|
|
114
114
|
"lineEnding": "\n"
|
|
115
115
|
},
|
|
116
|
-
"
|
|
116
|
+
"swaggerConfig": {
|
|
117
117
|
"url": "https://generator3.swagger.io/openapi2.json",
|
|
118
118
|
"apiListFileName": "index.ts",
|
|
119
119
|
"publicPrefix": "/api",
|
|
120
|
-
"
|
|
120
|
+
"modulePrefix": "/gateway",
|
|
121
121
|
"dataLevel": "serve",
|
|
122
122
|
"parameterSeparator": "_",
|
|
123
123
|
"headers": {
|
|
@@ -158,11 +158,11 @@ $ anl type
|
|
|
158
158
|
"varnames": "enum-varnames",
|
|
159
159
|
"comment": "enum-descriptions"
|
|
160
160
|
},
|
|
161
|
-
"
|
|
161
|
+
"swaggerConfig": [
|
|
162
162
|
{
|
|
163
163
|
"url": "https://generator3.swagger.io/openapi1.json",
|
|
164
164
|
"apiListFileName": "op.ts",
|
|
165
|
-
"
|
|
165
|
+
"modulePrefix": "/forward",
|
|
166
166
|
"dataLevel": "serve",
|
|
167
167
|
"parameterSeparator": "_",
|
|
168
168
|
"headers": {},
|
|
@@ -186,39 +186,39 @@ $ anl type
|
|
|
186
186
|
|
|
187
187
|
#### Explication des éléments de configuration
|
|
188
188
|
|
|
189
|
-
| Élément de configuration
|
|
190
|
-
|
|
|
191
|
-
| saveTypeFolderPath
|
|
192
|
-
| saveApiListFolderPath
|
|
193
|
-
| saveEnumFolderPath
|
|
194
|
-
| importEnumPath
|
|
195
|
-
| swaggerJsonUrl
|
|
196
|
-
|
|
|
197
|
-
|
|
|
198
|
-
|
|
|
199
|
-
|
|
|
200
|
-
|
|
|
201
|
-
|
|
|
202
|
-
|
|
|
203
|
-
|
|
|
204
|
-
|
|
|
205
|
-
|
|
|
206
|
-
| requestMethodsImportPath | string | Oui | Chemin d'import des méthodes de requête
|
|
207
|
-
| dataLevel | 'data' \| 'serve' \| 'axios' | Non | Configuration globale du niveau de données de retour d'interface, valeur par défaut : `'serve'`. Chaque serveur peut le configurer individuellement pour remplacer
|
|
208
|
-
| formatting | object | Non | Configuration du formatage du code
|
|
209
|
-
| formatting.indentation | string | Non | Caractère d'indentation du code, par exemple : `"\t"` ou `" "` (deux espaces)
|
|
210
|
-
| formatting.lineEnding | string | Non | Caractère de saut de ligne, par exemple : `"\n"` (LF) ou `"\r\n"` (CRLF)
|
|
211
|
-
| headers
|
|
212
|
-
| includeInterface | Array<{path: string, method: string}> | Non | Interfaces incluses globalement : Le fichier de liste d'interfaces spécifié par `saveApiListFolderPath` ne contiendra que les interfaces de la liste, mutuellement exclusif avec `excludeInterface`. Chaque serveur peut le configurer individuellement pour remplacer
|
|
213
|
-
| excludeInterface | Array<{path: string, method: string}> | Non | Interfaces exclues globalement : Le fichier de liste d'interfaces spécifié par `saveApiListFolderPath` ne contiendra pas les interfaces de cette liste, mutuellement exclusif avec `includeInterface`. Chaque serveur peut le configurer individuellement pour remplacer
|
|
214
|
-
| publicPrefix | string | Non | Préfixe commun global sur le chemin URL (migré vers `
|
|
215
|
-
|
|
|
216
|
-
| apiListFileName | string | Non | Nom du fichier de liste API global, par défaut `index.ts` (migré vers `
|
|
217
|
-
| enmuConfig | object | Oui | Objet de configuration d'énumération
|
|
218
|
-
| enmuConfig.erasableSyntaxOnly | boolean | Oui | Doit être cohérent avec l'option `compilerOptions.erasableSyntaxOnly` de tsconfig.json. Si `true`, génère un objet const au lieu d'un enum (syntaxe de type uniquement). Valeur par défaut : `false`
|
|
219
|
-
| enmuConfig.varnames | string | Non | Nom du champ dans le schéma Swagger contenant les noms personnalisés des membres d'enum. Valeur par défaut : `enum-varnames`.
|
|
220
|
-
| enmuConfig.comment | string | Non | Nom du champ dans le schéma Swagger contenant les descriptions des membres d'enum (utilisé pour générer des commentaires). Valeur par défaut : `enum-descriptions`.
|
|
221
|
-
| parameterSeparator | '$' \| '\_' | Non | Séparateur utilisé globalement entre les segments de chemin et les paramètres lors de la génération des noms d'API et des noms de type. Par exemple, `/users/{userId}/posts` avec le séparateur `'_'` génère `users_userId_posts_GET`. Valeur par défaut : `'_'`. Chaque serveur peut le configurer individuellement pour remplacer
|
|
189
|
+
| Élément de configuration | Type | Obligatoire | Description |
|
|
190
|
+
| ---------------------------------- | ------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
191
|
+
| saveTypeFolderPath | string | Oui | Chemin de sauvegarde des fichiers de définition de types |
|
|
192
|
+
| saveApiListFolderPath | string | Oui | Chemin de sauvegarde des fichiers de fonctions de requête API |
|
|
193
|
+
| saveEnumFolderPath | string | Oui | Chemin de sauvegarde des fichiers de données enum |
|
|
194
|
+
| importEnumPath | string | Oui | Chemin d'import enum (chemin des fichiers enum référencés dans apps/types/models/\*.ts) |
|
|
195
|
+
| swaggerJsonUrl | string | Non | Adresse du document Swagger JSON (migré vers `swaggerConfig`, conservé pour compatibilité avec les anciennes configurations) **Ce champ sera supprimé dans les versions futures** |
|
|
196
|
+
| swaggerConfig | object \| Array<object> | Non | Configuration des serveurs Swagger. Un seul serveur peut être directement rempli comme objet, plusieurs serveurs utilisent un tableau. Chaque serveur peut configurer `url`, `publicPrefix`, `apiListFileName`, `headers`<br />Ce champ correspond aux exemples de configuration d'un seul serveur Swagger et de plusieurs serveurs Swagger, veuillez faire défiler vers le haut pour voir |
|
|
197
|
+
| swaggerConfig[].url | string | Oui | Adresse du document Swagger JSON |
|
|
198
|
+
| swaggerConfig[].publicPrefix | string | Non | Préfixe commun sur le chemin URL, par exemple : api/users, api/users/{id}, api est le préfixe commun |
|
|
199
|
+
| swaggerConfig[].modulePrefix | string | Non | Préfixe de chemin de requête (peut être compris comme nom de module), sera ajouté automatiquement devant chaque chemin de requête API.<br />Par exemple : lorsque `modulePrefix: "/forward"`,<br />`/publicPrefix/modulePrefix/user` devient `/api/forward/user` |
|
|
200
|
+
| swaggerConfig[].apiListFileName | string | Non | Nom du fichier de liste API, par défaut `index.ts`. Lors de l'utilisation de plusieurs serveurs, le nom de fichier de chaque serveur doit être unique |
|
|
201
|
+
| swaggerConfig[].headers | object | Non | Configuration des en-têtes de requête pour ce serveur |
|
|
202
|
+
| swaggerConfig[].dataLevel | 'data' \| 'serve' \| 'axios' | Non | Niveau de données de retour d'interface pour ce serveur. Si non défini, utilise la configuration globale `dataLevel` |
|
|
203
|
+
| swaggerConfig[].parameterSeparator | '$' \| '\_' | Non | Séparateur utilisé lors de la génération des noms d'API et des noms de type pour ce serveur. Si non défini, utilise la configuration globale `parameterSeparator` |
|
|
204
|
+
| swaggerConfig[].includeInterface | Array<{path: string, method: string}> | Non | Liste des interfaces incluses pour ce serveur. Si non définie, utilise la configuration globale `includeInterface` |
|
|
205
|
+
| swaggerConfig[].excludeInterface | Array<{path: string, method: string}> | Non | Liste des interfaces exclues pour ce serveur. Si non définie, utilise la configuration globale `excludeInterface` |
|
|
206
|
+
| requestMethodsImportPath | string | Oui | Chemin d'import des méthodes de requête |
|
|
207
|
+
| dataLevel | 'data' \| 'serve' \| 'axios' | Non | Configuration globale du niveau de données de retour d'interface, valeur par défaut : `'serve'`. Chaque serveur peut le configurer individuellement pour remplacer |
|
|
208
|
+
| formatting | object | Non | Configuration du formatage du code |
|
|
209
|
+
| formatting.indentation | string | Non | Caractère d'indentation du code, par exemple : `"\t"` ou `" "` (deux espaces) |
|
|
210
|
+
| formatting.lineEnding | string | Non | Caractère de saut de ligne, par exemple : `"\n"` (LF) ou `"\r\n"` (CRLF) |
|
|
211
|
+
| headers | object | Non | Configuration des en-têtes de requête (migré vers `swaggerConfig`, conservé pour compatibilité avec les anciennes configurations) |
|
|
212
|
+
| includeInterface | Array<{path: string, method: string}> | Non | Interfaces incluses globalement : Le fichier de liste d'interfaces spécifié par `saveApiListFolderPath` ne contiendra que les interfaces de la liste, mutuellement exclusif avec `excludeInterface`. Chaque serveur peut le configurer individuellement pour remplacer |
|
|
213
|
+
| excludeInterface | Array<{path: string, method: string}> | Non | Interfaces exclues globalement : Le fichier de liste d'interfaces spécifié par `saveApiListFolderPath` ne contiendra pas les interfaces de cette liste, mutuellement exclusif avec `includeInterface`. Chaque serveur peut le configurer individuellement pour remplacer |
|
|
214
|
+
| publicPrefix | string | Non | Préfixe commun global sur le chemin URL (migré vers `swaggerConfig`, conservé pour compatibilité avec les anciennes configurations) |
|
|
215
|
+
| modulePrefix | string | Non | Préfixe de chemin de requête global (chaque serveur peut le configurer individuellement pour remplacer) |
|
|
216
|
+
| apiListFileName | string | Non | Nom du fichier de liste API global, par défaut `index.ts` (migré vers `swaggerConfig`, conservé pour compatibilité avec les anciennes configurations) |
|
|
217
|
+
| enmuConfig | object | Oui | Objet de configuration d'énumération |
|
|
218
|
+
| enmuConfig.erasableSyntaxOnly | boolean | Oui | Doit être cohérent avec l'option `compilerOptions.erasableSyntaxOnly` de tsconfig.json. Si `true`, génère un objet const au lieu d'un enum (syntaxe de type uniquement). Valeur par défaut : `false` |
|
|
219
|
+
| enmuConfig.varnames | string | Non | Nom du champ dans le schéma Swagger contenant les noms personnalisés des membres d'enum. Valeur par défaut : `enum-varnames`. |
|
|
220
|
+
| enmuConfig.comment | string | Non | Nom du champ dans le schéma Swagger contenant les descriptions des membres d'enum (utilisé pour générer des commentaires). Valeur par défaut : `enum-descriptions`. |
|
|
221
|
+
| parameterSeparator | '$' \| '\_' | Non | Séparateur utilisé globalement entre les segments de chemin et les paramètres lors de la génération des noms d'API et des noms de type. Par exemple, `/users/{userId}/posts` avec le séparateur `'_'` génère `users_userId_posts_GET`. Valeur par défaut : `'_'`. Chaque serveur peut le configurer individuellement pour remplacer |
|
|
222
222
|
|
|
223
223
|
#### Relation entre les éléments de configuration et les fichiers générés
|
|
224
224
|
|
|
@@ -284,7 +284,7 @@ Les éléments de configuration suivants prennent en charge le remplacement au n
|
|
|
284
284
|
- `parameterSeparator` : Séparateur pour les noms d'API et les noms de type
|
|
285
285
|
- `includeInterface` : Liste des interfaces incluses
|
|
286
286
|
- `excludeInterface` : Liste des interfaces exclues
|
|
287
|
-
- `
|
|
287
|
+
- `modulePrefix` : Préfixe de chemin de requête
|
|
288
288
|
- `publicPrefix` : Préfixe commun d'URL
|
|
289
289
|
- `headers` : Configuration des en-têtes de requête
|
|
290
290
|
|
|
@@ -294,7 +294,7 @@ Les éléments de configuration suivants prennent en charge le remplacement au n
|
|
|
294
294
|
{
|
|
295
295
|
"dataLevel": "serve",
|
|
296
296
|
"parameterSeparator": "_",
|
|
297
|
-
"
|
|
297
|
+
"swaggerConfig": [
|
|
298
298
|
{
|
|
299
299
|
"url": "http://api1.example.com/swagger.json",
|
|
300
300
|
"dataLevel": "data",
|
|
@@ -393,7 +393,7 @@ interface User {
|
|
|
393
393
|
```json
|
|
394
394
|
{
|
|
395
395
|
"dataLevel": "serve",
|
|
396
|
-
"
|
|
396
|
+
"swaggerConfig": [
|
|
397
397
|
{
|
|
398
398
|
"url": "http://api1.example.com/swagger.json",
|
|
399
399
|
"dataLevel": "data"
|
|
@@ -489,8 +489,8 @@ Note : `includeInterface` et `excludeInterface` ne peuvent pas être utilisés s
|
|
|
489
489
|
|
|
490
490
|
L'outil prend en charge la configuration de plusieurs serveurs Swagger, chaque serveur peut être configuré indépendamment :
|
|
491
491
|
|
|
492
|
-
- **Un seul serveur** : `
|
|
493
|
-
- **Plusieurs serveurs** : `
|
|
492
|
+
- **Un seul serveur** : `swaggerConfig` peut être directement rempli comme objet
|
|
493
|
+
- **Plusieurs serveurs** : `swaggerConfig` utilise un tableau, chaque serveur doit configurer un `apiListFileName` unique
|
|
494
494
|
|
|
495
495
|
**Principe de fonctionnement :**
|
|
496
496
|
|
|
@@ -506,11 +506,11 @@ Chaque serveur prend en charge une configuration indépendante des options suiva
|
|
|
506
506
|
- `parameterSeparator` - Séparateur pour les noms d'API et les noms de type
|
|
507
507
|
- `includeInterface` - Liste des interfaces incluses
|
|
508
508
|
- `excludeInterface` - Liste des interfaces exclues
|
|
509
|
-
- `
|
|
509
|
+
- `modulePrefix` - Préfixe de chemin de requête
|
|
510
510
|
|
|
511
|
-
#### Préfixe de Chemin (
|
|
511
|
+
#### Préfixe de Chemin (modulePrefix)
|
|
512
512
|
|
|
513
|
-
`
|
|
513
|
+
`modulePrefix` est utilisé pour ajouter automatiquement un préfixe devant tous les chemins de requête API, ce qui est particulièrement utile dans les scénarios suivants :
|
|
514
514
|
|
|
515
515
|
1. **Scénario de proxy inverse** : Lorsque le service backend est routé via un proxy inverse
|
|
516
516
|
2. **Gateway d'API** : Ajouter uniformément un préfixe de gateway devant le chemin
|
|
@@ -520,10 +520,10 @@ Chaque serveur prend en charge une configuration indépendante des options suiva
|
|
|
520
520
|
|
|
521
521
|
```json
|
|
522
522
|
{
|
|
523
|
-
"
|
|
523
|
+
"swaggerConfig": [
|
|
524
524
|
{
|
|
525
525
|
"url": "http://api.example.com/swagger.json",
|
|
526
|
-
"
|
|
526
|
+
"modulePrefix": "/forward",
|
|
527
527
|
"apiListFileName": "api.ts"
|
|
528
528
|
}
|
|
529
529
|
]
|
|
@@ -541,18 +541,18 @@ export const apiUserListGet = (params: ApiUserList_GET.Query) => GET<ApiUserList
|
|
|
541
541
|
**Différence avec publicPrefix :**
|
|
542
542
|
|
|
543
543
|
- `publicPrefix` : Utilisé pour supprimer le préfixe commun du chemin d'interface (n'affecte que le nom de fonction généré)
|
|
544
|
-
- `
|
|
544
|
+
- `modulePrefix` : Utilisé pour ajouter un préfixe devant le chemin de requête réel (affecte l'URL de requête à l'exécution)
|
|
545
545
|
|
|
546
546
|
**Exemple de configuration :**
|
|
547
547
|
|
|
548
548
|
```json
|
|
549
549
|
{
|
|
550
|
-
"
|
|
550
|
+
"swaggerConfig": [
|
|
551
551
|
{
|
|
552
552
|
"url": "http://api1.example.com/swagger.json",
|
|
553
553
|
"apiListFileName": "api1.ts",
|
|
554
554
|
"publicPrefix": "/api/v1",
|
|
555
|
-
"
|
|
555
|
+
"modulePrefix": "/forward",
|
|
556
556
|
"dataLevel": "serve",
|
|
557
557
|
"parameterSeparator": "_",
|
|
558
558
|
"headers": {
|
|
@@ -582,7 +582,7 @@ export const apiUserListGet = (params: ApiUserList_GET.Query) => GET<ApiUserList
|
|
|
582
582
|
|
|
583
583
|
```json
|
|
584
584
|
{
|
|
585
|
-
"
|
|
585
|
+
"swaggerConfig": [
|
|
586
586
|
{
|
|
587
587
|
"url": "http://api1.example.com/swagger.json",
|
|
588
588
|
"apiListFileName": "api1.ts",
|
|
@@ -607,7 +607,7 @@ export const apiUserListGet = (params: ApiUserList_GET.Query) => GET<ApiUserList
|
|
|
607
607
|
|
|
608
608
|
- Les anciennes configurations (`swaggerJsonUrl`, `publicPrefix`, `headers`) restent compatibles
|
|
609
609
|
- L'outil détectera automatiquement les anciennes configurations et suggérera des méthodes de migration
|
|
610
|
-
- Il est recommandé de migrer vers la nouvelle configuration `
|
|
610
|
+
- Il est recommandé de migrer vers la nouvelle configuration `swaggerConfig` pour une meilleure flexibilité
|
|
611
611
|
|
|
612
612
|
#### Support des méthodes HTTP
|
|
613
613
|
|
|
@@ -632,7 +632,7 @@ Toutes les méthodes prennent en charge les définitions de types sécurisées p
|
|
|
632
632
|
4. Il est recommandé d'ajouter les fichiers générés au contrôle de version
|
|
633
633
|
5. Lors de l'utilisation de plusieurs serveurs Swagger, assurez-vous que le `apiListFileName` de chaque serveur est unique pour éviter l'écrasement des fichiers
|
|
634
634
|
6. Lors de la configuration de plusieurs serveurs, les définitions de types et les enum seront fusionnées, si différents serveurs ont des types du même nom, des conflits peuvent survenir
|
|
635
|
-
7. La configuration au niveau du serveur (`dataLevel`, `parameterSeparator`, `includeInterface`, `excludeInterface`, `
|
|
635
|
+
7. La configuration au niveau du serveur (`dataLevel`, `parameterSeparator`, `includeInterface`, `excludeInterface`, `modulePrefix`) remplacera la configuration globale
|
|
636
636
|
8. `includeInterface` et `excludeInterface` ne peuvent pas être configurés simultanément. Si les deux sont configurés, `includeInterface` sera prioritaire
|
|
637
637
|
|
|
638
638
|
### Problèmes courants
|
|
@@ -645,15 +645,15 @@ Toutes les méthodes prennent en charge les définitions de types sécurisées p
|
|
|
645
645
|
- Vérifiez que la configuration requestMethodsImportPath est correcte
|
|
646
646
|
- Confirmez l'existence du fichier de méthodes de requête
|
|
647
647
|
|
|
648
|
-
3. **Quand utiliser `
|
|
648
|
+
3. **Quand utiliser `modulePrefix` ?**
|
|
649
649
|
- Lorsque votre API doit être accessible via un proxy inverse ou une passerelle
|
|
650
650
|
- Par exemple : Swagger définit `/api/user`, mais la requête réelle doit être `/gateway/api/user`
|
|
651
|
-
- Il suffit de définir `
|
|
651
|
+
- Il suffit de définir `modulePrefix: "/gateway"`
|
|
652
652
|
|
|
653
|
-
4. **Quelle est la différence entre `publicPrefix` et `
|
|
653
|
+
4. **Quelle est la différence entre `publicPrefix` et `modulePrefix` ?**
|
|
654
654
|
- `publicPrefix` : Supprime le préfixe du chemin d'interface, n'affecte que le nom de fonction généré
|
|
655
655
|
- Par exemple : `/api/user/list` après suppression de `/api`, le nom de fonction est `userListGet`
|
|
656
|
-
- `
|
|
656
|
+
- `modulePrefix` : Ajoute un préfixe devant le chemin de requête, affecte l'URL de requête réelle
|
|
657
657
|
- Par exemple : `/api/user/list` après ajout de `/forward`, l'URL de requête est `/forward/api/user/list`
|
|
658
658
|
|
|
659
659
|
5. **Comment configurer différents `dataLevel` pour plusieurs serveurs ?**
|
|
@@ -661,7 +661,7 @@ Toutes les méthodes prennent en charge les définitions de types sécurisées p
|
|
|
661
661
|
```json
|
|
662
662
|
{
|
|
663
663
|
"dataLevel": "serve",
|
|
664
|
-
"
|
|
664
|
+
"swaggerConfig": [
|
|
665
665
|
{
|
|
666
666
|
"url": "http://old-api.com/swagger.json",
|
|
667
667
|
"dataLevel": "axios",
|
|
@@ -682,7 +682,7 @@ Toutes les méthodes prennent en charge les définitions de types sécurisées p
|
|
|
682
682
|
- Utilisez la configuration `includeInterface` :
|
|
683
683
|
```json
|
|
684
684
|
{
|
|
685
|
-
"
|
|
685
|
+
"swaggerConfig": [
|
|
686
686
|
{
|
|
687
687
|
"url": "http://api.com/swagger.json",
|
|
688
688
|
"includeInterface": [
|
|
@@ -700,60 +700,60 @@ Toutes les méthodes prennent en charge les définitions de types sécurisées p
|
|
|
700
700
|
- Les fichiers de liste API et les fichiers de types sont régénérés à chaque fois
|
|
701
701
|
- Il est recommandé d'inclure les fichiers générés dans le contrôle de version pour faciliter la révision des modifications
|
|
702
702
|
|
|
703
|
-
|
|
703
|
+
8. **Quand utiliser `modulePrefix` ?**
|
|
704
704
|
- Lorsque votre API doit être accessible via un proxy inverse ou une passerelle
|
|
705
705
|
- Par exemple : Swagger définit `/api/user`, mais la requête réelle doit être `/gateway/api/user`
|
|
706
|
-
- Il suffit de définir `
|
|
706
|
+
- Il suffit de définir `modulePrefix: "/gateway"`
|
|
707
707
|
|
|
708
|
-
|
|
708
|
+
9. **Quelle est la différence entre `publicPrefix` et `modulePrefix` ?**
|
|
709
709
|
- `publicPrefix` : Supprime le préfixe du chemin d'interface, n'affecte que le nom de fonction généré
|
|
710
710
|
- Par exemple : `/api/user/list` après suppression de `/api`, le nom de fonction est `userListGet`
|
|
711
|
-
- `
|
|
711
|
+
- `modulePrefix` : Ajoute un préfixe devant le chemin de requête, affecte l'URL de requête réelle
|
|
712
712
|
- Par exemple : `/api/user/list` après ajout de `/forward`, l'URL de requête est `/forward/api/user/list`
|
|
713
713
|
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
|
|
736
|
-
|
|
737
|
-
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
748
|
-
|
|
749
|
-
|
|
750
|
-
|
|
751
|
-
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
714
|
+
10. **Comment configurer différents `dataLevel` pour plusieurs serveurs ?**
|
|
715
|
+
|
|
716
|
+
```json
|
|
717
|
+
{
|
|
718
|
+
"dataLevel": "serve",
|
|
719
|
+
"swaggerConfig": [
|
|
720
|
+
{
|
|
721
|
+
"url": "http://old-api.com/swagger.json",
|
|
722
|
+
"dataLevel": "axios",
|
|
723
|
+
"apiListFileName": "old-api.ts"
|
|
724
|
+
},
|
|
725
|
+
{
|
|
726
|
+
"url": "http://new-api.com/swagger.json",
|
|
727
|
+
"apiListFileName": "new-api.ts"
|
|
728
|
+
}
|
|
729
|
+
]
|
|
730
|
+
}
|
|
731
|
+
```
|
|
732
|
+
|
|
733
|
+
- `old-api.ts` utilise `dataLevel: "axios"`
|
|
734
|
+
- `new-api.ts` utilise le `dataLevel: "serve"` global
|
|
735
|
+
|
|
736
|
+
11. **Comment générer seulement des interfaces partielles ?**
|
|
737
|
+
- Utilisez la configuration `includeInterface` :
|
|
738
|
+
```json
|
|
739
|
+
{
|
|
740
|
+
"swaggerConfig": [
|
|
741
|
+
{
|
|
742
|
+
"url": "http://api.com/swagger.json",
|
|
743
|
+
"includeInterface": [
|
|
744
|
+
{ "path": "/api/user", "method": "get" },
|
|
745
|
+
{ "path": "/api/user/{id}", "method": "post" }
|
|
746
|
+
]
|
|
747
|
+
}
|
|
748
|
+
]
|
|
749
|
+
}
|
|
750
|
+
```
|
|
751
|
+
- Ou utilisez `excludeInterface` pour exclure les interfaces non désirées
|
|
752
|
+
|
|
753
|
+
12. **Que faire si les fichiers générés ont été écrasés ?**
|
|
754
|
+
- Les fichiers `config.ts`, `error-message.ts`, `fetch.ts`, `api-type.d.ts` ne sont générés que la première fois s'ils n'existent pas
|
|
755
|
+
- Les fichiers de liste API et les fichiers de types sont régénérés à chaque fois
|
|
756
|
+
- Il est recommandé d'inclure les fichiers générés dans le contrôle de version pour faciliter la révision des modifications
|
|
757
757
|
|
|
758
758
|
# Guide d'utilisation de la commande `anl lint`
|
|
759
759
|
|