परिचय
Cell क्लास Aspose.Cells FOSS for Java में मूलभूत इकाई है। यह टाइप्ड मानों को संग्रहीत करता है, उनके रनटाइम प्रकार को CellValueType एनोम के माध्यम से उजागर करता है, Excel द्वारा मूल्यांकन के लिए फ़ॉर्मूला स्ट्रिंग्स को स्थायी बनाता है, और getStringValue() के माध्यम से एक समान स्ट्रिंग प्रतिनिधित्व प्रदान करता है। यह पोस्ट सत्यापित उदाहरणों के साथ कोर सेल API का विस्तृत विश्लेषण करती है।
नीचे सभी कोड उदाहरण Maven निर्भरता का उपयोग करते हैं:
<dependency>
<groupId>com.aspose</groupId>
<artifactId>cells-foss</artifactId>
<version>1.0.0</version>
</dependency>
कोर सेल API
putValue() के साथ टाइप्ड मानों को संग्रहीत करना
Cell.putValue() छह जावा प्रकारों को स्वीकार करता है: String, int, double, boolean,
LocalDateTime, और Object। प्रत्येक कॉल सेल के आंतरिक मान को सेट करता है और निर्धारित करता है
CellValueType जो cell.getType() द्वारा लौटाया जाता है।
import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.CellValueType;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;
import java.time.LocalDateTime;
try (Workbook workbook = new Workbook()) {
Worksheet sheet = workbook.getWorksheets().get(0);
Cell a1 = sheet.getCells().get("A1");
a1.putValue("Revenue");
assert a1.getType() == CellValueType.STRING;
Cell b1 = sheet.getCells().get("B1");
b1.putValue(42500.75);
assert b1.getType() == CellValueType.NUMBER;
Cell c1 = sheet.getCells().get("C1");
c1.putValue(true);
assert c1.getType() == CellValueType.BOOLEAN;
Cell d1 = sheet.getCells().get("D1");
d1.putValue(LocalDateTime.of(2026, 4, 27, 9, 0, 0));
assert d1.getType() == CellValueType.DATE_TIME;
workbook.save("typed.xlsx");
}
खाली कोशिकाएँ CellValueType.BLANK को getType() से लौटाती हैं। पूर्णांक मान putValue(int) के साथ संग्रहीत होते हैं और XLSX सीरियलाइज़ेशन के माध्यम से राउंड‑ट्रिप करते हैं बिना दशमलव बिंदु के — getStringValue() "123" लौटाता है, "123.0" नहीं।
रनटाइम पर मानों का निरीक्षण
cell.getValue() कच्चा संग्रहीत मान Object के रूप में लौटाता है। cell.getStringValue()
एक लोकेल‑स्वतंत्र स्ट्रिंग प्रतिनिधित्व लौटाता है जो डाउनस्ट्रीम प्रोसेसिंग
या डिस्प्ले के लिए उपयुक्त है। CellValueType पर शाखा बनाना टाइप‑सेफ
वैल्यू एक्सट्रैक्शन के लिए अनुशंसित पैटर्न है:
import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.CellValueType;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;
try (Workbook workbook = new Workbook()) {
Worksheet sheet = workbook.getWorksheets().get(0);
sheet.getCells().get("A1").putValue("Hello");
sheet.getCells().get("B1").putValue(123);
sheet.getCells().get("C1").putValue(true);
sheet.getCells().get("D1").putValue(12.5d);
sheet.getCells().get("G1").setFormula("=B1*2");
Cell b1 = sheet.getCells().get("B1");
if (b1.getType() == CellValueType.NUMBER) {
System.out.println("Number: " + b1.getStringValue());
}
workbook.save("inspect.xlsx");
}
फ़ॉर्मूला संग्रह
फ़ॉर्मूला स्ट्रिंग्स cell.setFormula() के साथ संग्रहीत की जाती हैं। संग्रहीत फ़ॉर्मूला स्ट्रिंग = से शुरू होती है
और मानक Excel फ़ॉर्मूला सिंटैक्स का पालन करती है। getType() मेथड CellValueType.FORMULA लौटाता है
फ़ॉर्मूला सेल्स के लिए। Aspose.Cells FOSS for Java संग्रहीत करता है और
राउंड‑ट्रिप करता है फ़ॉर्मूले को XLSX; फ़ॉर्मूला खोलने पर Excel द्वारा पुनः गणना किया जाता है।
import com.aspose.cells_foss.Cell;
import com.aspose.cells_foss.CellValueType;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;
try (Workbook workbook = new Workbook()) {
Worksheet sheet = workbook.getWorksheets().get(0);
Cell b1 = sheet.getCells().get("B1");
b1.putValue(100.0);
Cell c1 = sheet.getCells().get("C1");
c1.setFormula("=B1*1.2");
assert c1.getType() == CellValueType.FORMULA;
workbook.save("formulas.xlsx");
}
XLSX राउंड-ट्रिप फिडेलिटी
सभी टाइप किए गए मान XLSX सीरियलाइज़ेशन और पुनः लोड के दौरान संरक्षित रहते हैं। लोड करते समय
मौजूदा .xlsx फ़ाइल new Workbook(path) या new Workbook(path, options) के साथLoadOptions का उपयोग करके रिपेयर मोड सक्षम किया जाता है। पुनः लोड के बाद, getType() और getStringValue()
लिखने के समय के समान मान लौटाते हैं।
import com.aspose.cells_foss.LoadIssue;
import com.aspose.cells_foss.LoadOptions;
import com.aspose.cells_foss.Workbook;
import com.aspose.cells_foss.Worksheet;
LoadOptions options = new LoadOptions();
options.setStrictMode(false);
options.setTryRepairPackage(true);
options.setTryRepairXml(true);
try (Workbook workbook = new Workbook("input.xlsx", options)) {
if (workbook.getLoadDiagnostics().hasRepairs()) {
for (LoadIssue issue : workbook.getLoadDiagnostics().getIssues()) {
System.out.println(issue.getMessage());
}
}
Worksheet sheet = workbook.getWorksheets().get(0);
System.out.println(sheet.getCells().get("A1").getStringValue());
workbook.save("output.xlsx");
}
समर्थित फ़ॉर्मेट
| फ़ॉर्मेट | एक्सटेंशन | पढ़ें | लिखें |
|---|---|---|---|
| Excel Open XML | .xlsx | ✓ | ✓ |
ओपन सोर्स और लाइसेंसिंग
Aspose.Cells FOSS for Java MIT लाइसेंस के तहत जारी किया गया है। आप इसे व्यक्तिगत, ओपन‑सोर्स और व्यावसायिक परियोजनाओं में बिना किसी प्रतिबंध के उपयोग, संशोधित और वितरित कर सकते हैं। स्रोत कोड उपलब्ध है github.com/aspose-cells-foss/Aspose.Cells-FOSS-for-Java.