LightCells API sını Kullanma
Olay Temelli Mimarilik
Aspose.Cells, özellikle bellekte bir veri modeli bloğu oluşturmadan hücre verilerini bir bir işlemek için tasarlanmış olan LightCells API’sını sağlar (Hücre koleksiyonu vb. kullanılmadan). Olay temelli modda çalışır.
Çalışma kitaplarını kaydetmek için kaydederken hücre içeriğini hücre hücre sağlayın ve bileşen bunu doğrudan çıktı dosyasına kaydeder.
Şablon dosyalarını okurken bileşen her hücreyi ayrı ayrı ayrıştırır ve değerlerini tek tek sağlar.
Her iki süreçte de bir Cell nesnesi işlenir ve ardından atılır, Workbook nesnesi koleksiyonu tutmaz. Bu modda, dolayısıyla, çok miktarda bellek kullanan büyük veri kümesi barındıran Microsoft Excel dosyasının içe aktarımı ve dışa aktarımı sırasında bellek kaydedilir.
LightCells API, XLSX ve XLS dosyaları için hücreleri aynı şekilde işlemesine rağmen (bütün hücreleri belleğe yüklemez ama bir hücreyi işler ve ardından atar), XLSX dosyaları için XLS dosyalarına göre belleği daha etkili bir şekilde saklar çünkü iki formatın farklı veri modelleri ve yapıları vardır.
Ancak, XLS dosyaları için, geliştiriciler kayıt işlemi sırasında oluşturulan geçici veri için bir geçici konum belirtebilirler. Genellikle LightCells API’nin kullanılması XLSX dosyası için% 50 veya daha fazla bellek tasarrufu sağlayabilirken, XLS için kullanılması% 20-40’a kadar bellek tasarrufu sağlayabilir.
Büyük Excel Dosyaları Yazma
Aspose.Cells, programınızda uygulanması gereken LightCellsDataProvider arabirimini sağlar. Bu arabirim, hafif modda büyük elektronik tablo dosyalarını kaydetme için veri sağlayıcısını temsil eder.
Bu modda bir çalışma kitabı kaydedilirken, her çalışma tablosu her okunduğunda startSheet(int) kontrol edilir. Bir sayfa için, eğer startSheet(int) true ise, bu sayfanın satırlarındaki hücrelerin veri ve özellikleri bu uygulama tarafından sağlanır. İlk olarak, bir sonraki satır endeksini kaydedilmek üzere çağrılır. Eğer geçerli bir satır endeksi dönerse (satır endeksi kaydedilecek satırların artan sırayla olması gerekir), bu satırı temsil eden bir Row nesnesi uygulamaya verilir ve özellikleri startRow(Row) ile ayarlaması beklenir.
Bir satır için, öncelikle nextCell() kontrol edilir. Eğer geçerli bir sütun endeksi dönerse (bir satırın tüm hücreleri sırasıyla kaydedilmek üzere artan sırada sütun endeksi olmalıdır), bu hücreyi temsil eden bir Cell nesnesi uygulamaya verilir ve veri ve özellikleri startCell(Cell) ile ayarlanması beklenir. Bu hücrenin verileri ayarlandıktan sonra bu hücre doğrudan oluşturulan elektronik tablo dosyasına kaydedilir ve bir sonraki hücre kontrol edilir ve işlenir.
Aşağıdaki örnek, LightCells API’nin nasıl çalıştığını gösterir.
Aşağıdaki program, çalışma sayfasında 100.000 kayıtlı devasa bir dosya oluşturur, veriyle doldurulur. Bazı hiperbağlantılar, dize değerleri, sayısal değerler ve belirli hücrelere formüller ekledik. Ayrıca, bazı hücre aralıklarını biçimlendirdik.
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
| public class LightCellsDataProviderDemo implements LightCellsDataProvider { | |
| private final int sheetCount; | |
| private final int maxRowIndex; | |
| private final int maxColIndex; | |
| private int rowIndex; | |
| private int colIndex; | |
| private final Style style1; | |
| private final Style style2; | |
| public LightCellsDataProviderDemo(Workbook wb, int sheetCount, int rowCount, int colCount) { | |
| // set the variables/objects | |
| this.sheetCount = sheetCount; | |
| this.maxRowIndex = rowCount - 1; | |
| this.maxColIndex = colCount - 1; | |
| // add new style object with specific formattings | |
| style1 = wb.createStyle(); | |
| Font font = style1.getFont(); | |
| font.setName("MS Sans Serif"); | |
| font.setSize(10); | |
| font.setBold(true); | |
| font.setItalic(true); | |
| font.setUnderline(FontUnderlineType.SINGLE); | |
| font.setColor(Color.fromArgb(0xffff0000)); | |
| style1.setHorizontalAlignment(TextAlignmentType.CENTER); | |
| // create another style | |
| style2 = wb.createStyle(); | |
| style2.setCustom("#,##0.00"); | |
| font = style2.getFont(); | |
| font.setName("Copperplate Gothic Bold"); | |
| font.setSize(8); | |
| style2.setPattern(BackgroundType.SOLID); | |
| style2.setForegroundColor(Color.fromArgb(0xff0000ff)); | |
| style2.setBorder(BorderType.TOP_BORDER, CellBorderType.THICK, Color.getBlack()); | |
| style2.setVerticalAlignment(TextAlignmentType.CENTER); | |
| } | |
| public boolean isGatherString() { | |
| return false; | |
| } | |
| public int nextCell() { | |
| if (colIndex < maxColIndex) { | |
| colIndex++; | |
| return colIndex; | |
| } | |
| return -1; | |
| } | |
| public int nextRow() { | |
| if (rowIndex < maxRowIndex) { | |
| rowIndex++; | |
| colIndex = -1; // reset column index | |
| if (rowIndex % 1000 == 0) { | |
| System.out.println("Row " + rowIndex); | |
| } | |
| return rowIndex; | |
| } | |
| return -1; | |
| } | |
| public void startCell(Cell cell) { | |
| if (rowIndex % 50 == 0 && (colIndex == 0 || colIndex == 3)) { | |
| // do not change the content of hyperlink. | |
| return; | |
| } | |
| if (colIndex < 10) { | |
| cell.putValue("test_" + rowIndex + "_" + colIndex); | |
| cell.setStyle(style1); | |
| } else { | |
| if (colIndex == 19) { | |
| cell.setFormula("=Rand() + test!L1"); | |
| } else { | |
| cell.putValue(rowIndex * colIndex); | |
| } | |
| cell.setStyle(style2); | |
| } | |
| } | |
| public void startRow(Row row) { | |
| row.setHeight(25); | |
| } | |
| public boolean startSheet(int sheetIndex) { | |
| if (sheetIndex < sheetCount) { | |
| // reset row/column index | |
| rowIndex = -1; | |
| colIndex = -1; | |
| return true; | |
| } | |
| return false; | |
| } | |
| } |
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
| public class Demo { | |
| private static final String OUTPUT_FILE_PATH = Utils.getDataDir(LightCellsDataProviderDemo.class); | |
| public static void main(String[] args) throws Exception { | |
| // Instantiate a new Workbook | |
| Workbook wb = new Workbook(); | |
| // set the sheet count | |
| int sheetCount = 1; | |
| // set the number of rows for the big matrix | |
| int rowCount = 100000; | |
| // specify the worksheet | |
| for (int k = 0; k < sheetCount; k++) { | |
| Worksheet sheet = null; | |
| if (k == 0) { | |
| sheet = wb.getWorksheets().get(k); | |
| sheet.setName("test"); | |
| } else { | |
| int sheetIndex = wb.getWorksheets().add(); | |
| sheet = wb.getWorksheets().get(sheetIndex); | |
| sheet.setName("test" + sheetIndex); | |
| } | |
| Cells cells = sheet.getCells(); | |
| // set the columns width | |
| for (int j = 0; j < 15; j++) { | |
| cells.setColumnWidth(j, 15); | |
| } | |
| // traverse the columns for adding hyperlinks and merging | |
| for (int i = 0; i < rowCount; i++) { | |
| // The first 10 columns | |
| for (int j = 0; j < 10; j++) { | |
| if (j % 3 == 0) { | |
| cells.merge(i, j, 1, 2, false, false); | |
| } | |
| if (i % 50 == 0) { | |
| if (j == 0) { | |
| sheet.getHyperlinks().add(i, j, 1, 1, "test!A1"); | |
| } else if (j == 3) { | |
| sheet.getHyperlinks().add(i, j, 1, 1, "http://www.google.com"); | |
| } | |
| } | |
| } | |
| // The second 10 columns | |
| for (int j = 10; j < 20; j++) { | |
| if (j == 12) { | |
| cells.merge(i, j, 1, 3, false, false); | |
| } | |
| } | |
| } | |
| } | |
| // Create an object with respect to LightCells data provider | |
| LightCellsDataProviderDemo dataProvider = new LightCellsDataProviderDemo(wb, 1, rowCount, 20); | |
| // Specify the XLSX file's Save options | |
| OoxmlSaveOptions opt = new OoxmlSaveOptions(); | |
| // Set the data provider for the file | |
| opt.setLightCellsDataProvider(dataProvider); | |
| // Save the big file | |
| wb.save(OUTPUT_FILE_PATH + "/DemoTest.xlsx", opt); | |
| } | |
| } |
Büyük Excel Dosyaları Okuma
Aspose.Cells, programınızda uygulanması gereken LightCellsDataHandler arabirimini sağlar. Bu arabirim, hafif modda büyük elektronik tablo dosyalarını okuma için veri sağlayıcısını temsil eder.
Bu modda bir çalışma kitabı okunurken, her çalışma tablosu her okunduğunda startSheet() kontrol edilir. Bir sayfa için, eğer startSheet() true dönerse, bu sayfanın satırlarındaki hücrelerin veri ve özellikleri kontrol edilir ve işlenir. Her satır için, processRow() çalıştığı ve satırın hücreleri de işlenmesi gerekiyorsa, startCell() her hücre için kontrol edilir.
Hücrelerin de işlenmesi gerekiyorsa, processRow() true döner ve her satırdaki mevcut hücre için startCell() kontrol edilir. Eğer işlenmesi gerekiyorsa, processCell() çalıştırılır.
Aşağıdaki örnek kod bu süreci açıklar. Program, milyonlarca kaydı içeren büyük bir dosyayı okur. Kitaptaki her çalışma sayfasını okumak biraz zaman alır. Örnek kod, dosyayı okur ve her çalışma sayfası için toplam hücre sayısını, dize sayısını ve formül sayısını alır.
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
| public class LightCellsTest1 { | |
| public static void main(String[] args) throws Exception { | |
| String dataDir = Utils.getDataDir(LightCellsTest1.class); | |
| LoadOptions opts = new LoadOptions(); | |
| LightCellsDataHandlerVisitCells v = new LightCellsDataHandlerVisitCells(); | |
| opts.setLightCellsDataHandler((LightCellsDataHandler) v); | |
| Workbook wb = new Workbook(dataDir + "LargeBook1.xlsx", opts); | |
| int sheetCount = wb.getWorksheets().getCount(); | |
| System.out.println("Total sheets: " + sheetCount + ", cells: " + v.cellCount + ", strings: " + v.stringCount | |
| + ", formulas: " + v.formulaCount); | |
| } | |
| } |
LightCellsDataHandler arabirimini uygulayan bir sınıf
| // For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java | |
| public class LightCellsDataHandlerVisitCells implements LightCellsDataHandler { | |
| public int cellCount; | |
| public int formulaCount; | |
| public int stringCount; | |
| public LightCellsDataHandlerVisitCells() { | |
| this.cellCount = 0; | |
| this.formulaCount = 0; | |
| this.stringCount = 0; | |
| } | |
| public int cellCount() { | |
| return cellCount; | |
| } | |
| public int formulaCount() { | |
| return formulaCount; | |
| } | |
| public int stringCount() { | |
| return stringCount; | |
| } | |
| public boolean startSheet(Worksheet sheet) { | |
| System.out.println("Processing sheet[" + sheet.getName() + "]"); | |
| return true; | |
| } | |
| public boolean startRow(int rowIndex) { | |
| return true; | |
| } | |
| public boolean processRow(Row row) { | |
| return true; | |
| } | |
| public boolean startCell(int column) { | |
| return true; | |
| } | |
| public boolean processCell(Cell cell) { | |
| this.cellCount = this.cellCount + 1; | |
| if (cell.isFormula()) { | |
| this.formulaCount = this.formulaCount + 1; | |
| } else if (cell.getType() == CellValueType.IS_STRING) { | |
| this.stringCount = this.stringCount + 1; | |
| } | |
| return false; | |
| } | |
| } |