Управление внешними ресурсами с помощью WorkbookSetting.StreamProvider

Возможные сценарии использования

Иногда ваш файл Excel содержит внешние ресурсы, например, связанные изображения и т. д. Aspose.Cells позволяет управлять этими внешними ресурсами с использованием Workbook.Settings.StreamProvider, который принимает реализацию интерфейса IStreamProvider. Когда вы попытаетесь отобразить вашу книгу, содержащую внешние ресурсы, например, связанные изображения, будут вызваны методы интерфейса IStreamProvider, которые позволят вам принять соответствующие действия для ваших внешних ресурсов.

Управление внешними ресурсами с помощью WorkbookSetting.StreamProvider

Приведенный ниже образец кода объясняет использование Workbook.Settings.StreamProvider. Он загружает образец файла Excel, содержащий связанное изображение. Код заменяет связанное изображение на логотип Aspose и отображает всю книгу в одно изображение с использованием класса SheetRender. Ниже приведено скриншот, показывающий образец файла Excel и его изображение для отображения в качестве справки. Как видите, сломанное связанное изображение заменено логотипом Aspose.

Образец кода

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
//Implementation of IStreamProvider
class SP implements IStreamProvider
{
	public void closeStream(StreamProviderOptions arg0) throws Exception {
	}

	public void initStream(StreamProviderOptions options) throws Exception {

		//Open the filestream of Aspose Logo and assign it to StreamProviderOptions.Stream property
		File imgFile = new File(srcDir + "sampleControlExternalResourcesUsingWorkbookSetting_StreamProvider.png");

		byte[] bts = new byte[(int) imgFile.length()];

		FileInputStream fin = new FileInputStream(imgFile);
		fin.read(bts);
		fin.close();

		ByteArrayOutputStream baout = new ByteArrayOutputStream();
		baout.write(bts);
		baout.close();
		
		options.setStream(baout);
	}
}


public void Run() throws Exception {
	System.out.println("Aspose.Cells for Java Version: " + CellsHelper.getVersion());

	//String srcDir = Utils.Get_SourceDirectory();
	//String outDir = Utils.Get_OutputDirectory();

	//Load sample Excel file containing the external resource e.g. linked image etc.
	Workbook wb = new Workbook(srcDir + "sampleControlExternalResourcesUsingWorkbookSetting_StreamProvider.xlsx");

	//Provide your implementation of IStreamProvider
	wb.getSettings().setStreamProvider(new SP());

	//Access first worksheet
	Worksheet ws = wb.getWorksheets().get(0);

	//Specify image or print options, we need one page per sheet and png output
	ImageOrPrintOptions opts = new ImageOrPrintOptions();
	opts.setOnePagePerSheet(true);
	opts.setImageType(ImageType.PNG);

	//Create sheet render by passing required parameters
	SheetRender sr = new SheetRender(ws, opts);

	//Convert your entire worksheet into png image
	sr.toImage(0, outDir + "outputControlExternalResourcesUsingWorkbookSettingStreamProvider.png");

	// Print the message
	System.out.println("ControlExternalResourcesUsingWorkbookSetting_StreamProvider executed successfully.");
}

public static void main(String[] args) throws Exception {
	new ControlExternalResourcesUsingWorkbookSetting_StreamProvider().Run();
}