fs/lib/DuplexCollection.js

  1. import AbstractReaderWriter from "./AbstractReaderWriter.js";
  2. import ReaderCollectionPrioritized from "./ReaderCollectionPrioritized.js";
  4. /**
  5.  * Wrapper to keep readers and writers together
  6.  *
  7.  * @public
  8.  * @class
  9.  * @alias @ui5/fs/DuplexCollection
  10.  * @extends @ui5/fs/AbstractReaderWriter
  11.  */
  12. class DuplexCollection extends AbstractReaderWriter {
  13. 	/**
  14. 	 * The Constructor.
  15. 	 *
  16. 	 * @param {object} parameters
  17. 	 * @param {@ui5/fs/AbstractReader} parameters.reader Single reader or collection of readers
  18. 	 * @param {@ui5/fs/AbstractReaderWriter} parameters.writer
  19. 	 *			A ReaderWriter instance which is only used for writing files
  20. 	 * @param {string} [parameters.name=""] The collection name
  21. 	 */
  22. 	constructor({reader, writer, name = ""}) {
  23. 		super(name);
  25. 		if (!reader) {
  26. 			throw new Error(`Cannot create DuplexCollection ${this._name}: No reader provided`);
  27. 		}
  28. 		if (!writer) {
  29. 			throw new Error(`Cannot create DuplexCollection ${this._name}: No writer provided`);
  30. 		}
  32. 		this._reader = reader;
  33. 		this._writer = writer;
  35. 		this._combo = new ReaderCollectionPrioritized({
  36. 			name: `${name} - ReaderCollectionPrioritized`,
  37. 			readers: [
  38. 				writer,
  39. 				reader
  40. 			]
  41. 		});
  42. 	}
  44. 	/**
  45. 	 * Locates resources by glob.
  46. 	 *
  47. 	 * @private
  48. 	 * @param {string|string[]} virPattern glob pattern as string or an array of
  49. 	 *         glob patterns for virtual directory structure
  50. 	 * @param {object} options glob options
  51. 	 * @param {@ui5/fs/tracing.Trace} trace Trace instance
  52. 	 * @returns {Promise<@ui5/fs/Resource[]>} Promise resolving with a list of resources
  53. 	 */
  54. 	_byGlob(virPattern, options, trace) {
  55. 		return this._combo._byGlob(virPattern, options, trace);
  56. 	}
  58. 	/**
  59. 	 * Locates resources by path.
  60. 	 *
  61. 	 * @private
  62. 	 * @param {string} virPath Virtual path
  63. 	 * @param {object} options Options
  64. 	 * @param {@ui5/fs/tracing.Trace} trace Trace instance
  65. 	 * @returns {Promise<@ui5/fs/Resource|null>}
  66. 	 *   Promise resolving to a single resource or <code>null</code> if no resource is found
  67. 	 */
  68. 	_byPath(virPath, options, trace) {
  69. 		return this._combo._byPath(virPath, options, trace);
  70. 	}
  72. 	/**
  73. 	 * Writes the content of a resource to a path.
  74. 	 *
  75. 	 * @private
  76. 	 * @param {@ui5/fs/Resource} resource The Resource to write
  77. 	 * @returns {Promise<undefined>} Promise resolving once data has been written
  78. 	 */
  79. 	_write(resource) {
  80. 		return this._writer.write(resource);
  81. 	}
  82. }
  84. export default DuplexCollection;