Я не зрозумів, як їх класифікувати?
Простори імен використовуються для організації / інкапсуляції вашого коду. Зовнішні модулі використовуються для організації / інкапсуляції вашого коду І для пошуку коду під час виконання. На практиці у вас є два варіанти під час виконання: 1) поєднати весь перекладений код в один файл, або 2) використовувати зовнішні модулі, мати декілька файлів і вимагати деякого іншого механізму, щоб отримати ці файли.
Коли експортувати клас чи простір імен чи пакет?
Щоб зробити тип або значення видимими поза файлом, у якому він знаходиться, його потрібно експортувати, якщо він знаходиться в просторі імен. Якщо ви експортуєте його на верхньому рівні чи в просторі імен, вирішите, чи тепер він знаходиться у зовнішньому модулі.
Якщо ми експортуємо пакет / простір імен, всі класи, що експортуються, або повинні бути явно експортовані
Класи в просторі імен завжди повинні бути явно експортовані для того, щоб клас був видимим під час компіляції поза файлом, у якому він визначений.
Як кожен з них можна імпортувати / вимагати?
Це залежить від того, якщо ви використовуєте зовнішні модулі. Зовнішній модуль завжди потрібно імпортувати, щоб "використовувати" його. Імпорт простору імен, який не знаходиться у зовнішньому модулі, насправді просто надає псевдонім для простору імен - вам все одно потрібно встановити префікс типу / що завгодно з псевдонімом (і саме тому ви зазвичай не бажаєте використовувати простори імен із зовнішніми модулями; це означає, що вам завжди потрібно використовувати префікс при посиланні на все, що надається зовнішнім модулем.) Простори імен, які не є у зовнішньому модулі, можуть охоплювати файли, тому якщо ви знаходитесь в одному просторі імен, ви можете звернутися до всього, що експортується простір імен без необхідності будь-якого імпорту.
Щоб реально зрозуміти вищесказане, потрібні основні знання. Головне, що потрібно розуміти з посиланнями / просторами імен / зовнішніми модулями, - це те, що ці конструкції роблять під час компіляції та що вони роблять під час виконання.
Довідкові директиви використовуються під час компіляції для пошуку інформації про тип. У вашому джерелі є певний символ. Як компілятор TypeScript знаходить визначення цього символу? Довідкова директива значною мірою поширюється механізмом tsconfig.json - використовуючи tsconfig.json, ви повідомляєте компілятору, де всі ваші джерела.
Простори імен можуть містити визначення типів та / або реалізацію. Якщо простір імен містить лише інформацію про тип, то він взагалі не має проявів виконання - ви можете перевірити це, подивившись на вихід JS та знайдіть порожній файл JS. Якщо у просторі імен є код реалізації, то код загортається всередину закриття, яке присвоюється глобальній змінній з тим самим іменем, що і простір імен. З вкладеними просторами імен з'явиться глобальна змінна для простору імен кореня. Ще раз перевірте вихід JS. Простори імен - це історично те, як бібліотеки на стороні клієнта JS намагалися уникнути проблеми із зіткненнями імен. Ідея полягає в тому, щоб згорнути всю вашу бібліотеку в одне закриття, а потім виставити якомога менший глобальний слід - лише одну глобальну змінну, що посилається на закриття. Ну, проблема все ще полягає в тому, що ви заявили ім’я в глобальному просторі. Що робити, якщо ви хотіли, скажімо, двох версій бібліотеки? У просторі імен TypeScript все ще виникає питання про те, як знайти джерело для простору імен. Тобто у вихідному коді, на який посилається AB, все ще виникає проблема сказати компілятору, як знайти AB - або за допомогою довідкових директив, або за допомогою tsconfig.json. Або помістивши простір імен у зовнішній модуль, а потім імпортуючи зовнішній модуль.
Зовнішні модулі походять із JS на стороні сервера. Між зовнішнім модулем і файлом у файловій системі існує відповідність один одному. Ви можете використовувати структуру каталогів файлової системи для організації зовнішніх модулів у вкладену структуру. Імпорт зовнішнього модуля, як правило, завжди вводить залежність від цього зовнішнього модуля (виняток - коли ви імпортуєте зовнішній модуль, але потім не використовуєте жоден його експорт у позиційній позиції - тобто ви імпортуєте лише зовнішній модуль отримати інформацію про його тип). Зовнішній модуль неявно перебуває у закритті, і це важливо: користувач модуля може призначити закриття будь-якій локальній змінній, яку вони хочуть. TypeScript / ES6 додає додатковий синтаксис навколо відображення експорту зовнішніх модулів до локальних імен, але це лише суть. На стороні сервера, розміщення зовнішнього модуля відносно прямо: просто знайдіть файл, що представляє зовнішній модуль, у локальній файловій системі. Якщо ви хочете використовувати зовнішні модулі на стороні клієнта, у браузері він стає складнішим, оскільки немає еквівалента файловій системі, яка має модуль для завантаження. Тож тепер на стороні клієнта вам потрібен спосіб зв'язати всі ті файли у форму, яку можна віддалено використовувати у браузері - саме тут вбудовані модулі типу Webpack (хоча Webpack робить чорт набагато більше, ніж модулі пакетів) і Перегляньте, вступайте в гру. Модулі постачальників дозволяють виконувати роздільну здатність зовнішніх модулів у браузері. у браузері він стає складнішим, оскільки немає еквівалента файловій системі, яка має модуль для завантаження. Тож тепер на стороні клієнта вам потрібен спосіб зв'язати всі ці файли у форму, яку можна віддалено використовувати у браузері - саме тут вбудовані модулі типу Webpack (хоча Webpack робить чорт набагато більше, ніж модулі пакетів) і Перегляньте, вступайте в гру. Модулі постачальників дозволяють виконувати роздільну здатність зовнішніх модулів у браузері. у браузері він стає складнішим, оскільки немає еквівалента файловій системі, яка має модуль для завантаження. Тож тепер на стороні клієнта вам потрібен спосіб зв'язати всі ці файли у форму, яку можна віддалено використовувати у браузері - саме тут вбудовані модулі типу Webpack (хоча Webpack робить чорт набагато більше, ніж модулі пакетів) і Перегляньте, вступайте в гру. Модулі постачальників дозволяють виконувати роздільну здатність зовнішніх модулів у браузері.
Реальний сценарій: AngularJS. Прикиньте зовнішні модулі не існують, використовуйте єдиний простір імен для обмеження забруднення глобального простору (у прикладі нижче однієї змінної MyApp є все, що є у глобальному просторі), експортуйте лише інтерфейси та використовуйте AngularJS-залежність-injection для здійснення реалізацій доступний для використання. Покладіть всі класи в корінь каталогів, додайте tsconfig.json до кореня, встановіть типи angularjs під тим же коренем каталогу, щоб tsconfig.json також підбирав його, поєднував увесь вихідний файл в один JS-файл. Це буде добре для більшості проектів, якщо повторне використання коду не викликає особливих проблем.
MyService.ts:
namespace MyApp {
// without an export the interface is not visible outside of MyService.ts
export interface MyService {
....
}
// class is not exported; AngularJS DI will wire up the implementation
class MyServiceImpl implements MyService {
}
angular.module("MyApp").service("myService", MyServiceImpl);
}
MyController.ts:
namespace MyApp {
class MyController {
// No import of MyService is needed as we are spanning
// one namespace with multiple files.
// MyService is only used at compile time for type checking.
// AngularJS DI is done on the name of the variable.
constructor(private myService: MyService) {
}
}
angular.module("MyApp").controller("myController", MyController);
}
Використання IIFE, щоб уникнути забруднення глобальної області виконання. У цьому прикладі взагалі не створюються глобальні змінні. (Передбачається tsconfig.json.)
Foo.ts:
namespace Foo {
// without an export IFoo is not visible. No JS is generated here
// as we are only defining a type.
export interface IFoo {
x: string;
}
}
interface ITopLevel {
z: string;
}
(function(){
// export required above to make IFoo visible as we are not in the Foo namespace
class Foo1 implements Foo.IFoo {
x: string = "abc";
}
// do something with Foo1 like register it with a DI system
})();
Bar.ts:
// alias import; no external module created
import IFoo = Foo.IFoo;
(function() {
// Namespace Foo is always visible as it was defined at
// top level (outside of any other namespace).
class Bar1 implements Foo.IFoo {
x: string;
}
// equivalent to above
class Bar2 implements IFoo {
x: string;
}
// IToplevel is visible here for the same reason namespace Foo is visible
class MyToplevel implements ITopLevel {
z: string;
}
})();
Використовуючи IIFE, ви можете усунути введення MyApp як глобальної змінної у першому прикладі.
MyService.ts:
interface MyService {
....
}
(function() {
class MyServiceImpl implements MyService {
}
angular.module("MyApp").service("myService", MyServiceImpl);
})();
MyController.ts:
(function() {
class MyController {
constructor(private myService: MyService) {
}
}
angular.module("MyApp").controller("myController", MyController);
})();