限制與 API 差異

公共 API 差異

此清單使用範例程式碼段，展示 Aspose.Slides for Java 與透過 Java API 的 Aspose.Slides for PHP 之間的若干差異。

匯入函式庫（套件比較）

Aspose.Slides for Java

import com.aspose.slides.*;

Aspose.Slides for PHP via Java

require_once("Java.inc");
require_once("lib/aspose.slides.php");

use aspose\sldes;
use aspose\sldes\Presentation;

建立新的簡報

Aspose.Slides for Java

Presentation presentation = new Presentation();

Aspose.Slides for PHP via Java

$presentation = new Presentation();

列舉或常數

Aspose.Slides for Java

arc2.getLineFormat().setDashStyle(MsoLineDashStyle.SOLID);

Aspose.Slides for PHP via Java

$arc2->getLineFormat()->setDashStyle(slides\MsoLineDashStyle::SOLID);

範例

Aspose.Slides for Java

import com.aspose.slides.ISlide;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.ShapeType;

public class Test
{
    public static void main(String[] args) throws Exception
    {
        // 實例化一個表示簡報檔案的 Presentation 物件
        Presentation pres = new Presentation();
        try
        {
            // 取得第一張投影片
            ISlide slide = pres.getSlides().get_Item(0);

            // 新增一個類型設定為線條的自動形狀
            slide.getShapes().addAutoShape(ShapeType.Line, 50, 150, 300, 0);
            pres.save("NewPresentation_out.pptx", SaveFormat.Pptx);
        }
        finally
        {
            if (pres != null) pres.dispose();
        }
    }
}

Aspose.Slides for PHP via Java

<?php
require_once("Java.inc");
require_once("lib/aspose.slides.php");

use aspose\slides;
use aspose\slides\Presentation;
use aspose\slides\ShapeType;
use aspose\slides\SaveFormat;

$pres = new Presentation();
try
{
    // 取得第一張投影片
    $slide = $pres->getSlides()->get_Item(0);

    // 新增一個類型設定為線條的自動形狀
    $slide->getShapes()->addAutoShape(ShapeType::Line, 50, 150, 300, 0);
    $pres->save("NewPresentation_out.pptx", SaveFormat::Pptx);
}
finally
{
    if (!java_is_null($pres)) $pres->dispose();
}
?>

相較於 Aspose.Slides for Java API，Aspose.Slides for PHP via Java API 的其他限制

Aspose.Slides 的命名空間以及其使用的 Java 類別，都是由 PhpJavaBridge 以 com.aspose.slides 套件中同名的 Java 類別為基礎所建立的包裝器。

1. 包裝 Java 參數與引數

它們回傳與接受的參數與引數都是以相同名稱的 Java 類別為基礎的包裝器。只有字串與數值型別會自動轉換，陣列、集合、位元組與布林值則不會轉換。

常見錯誤：

if ($node->isAssistant()) - wrong!
if (java_values($node->isAssistant())) - correct!

2. 繼承 Java 類別與 instanceof 運算子

不能從 PHP 類別繼承 Java 類別。作為變通方法，您可以在需要時使用組合。instanceof 運算子僅適用於具體類別，無法用於類別的介面或父類別。

workaround

3. Java 陣列不是 PHP 陣列

在 PHP 中建立 Java 陣列：

$Array = new JavaClass("java.lang.reflect.Array");
$Integer = new JavaClass("java.lang.Integer");
$IntegerArray = $Array->newInstance($Integer, 2);
$IntegerArray[0] = 1;
$IntegerArray[1] = 0;

4. 取得 Java 陣列長度

$data->length; - does NOT work

workaround

$Array = new JavaClass("java.lang.reflect.Array");
$Array->getLength($data);

5. Java 方法 Files.readAllBytes

$htmlBytes = Files->readAllBytes(Paths->get("embedOle.html")); - does NOT work

workaround

$file = new Java("java.io.File", "embedOle.html");
$Array = new JavaClass("java.lang.reflect.Array");
$Byte = new JavaClass("java.lang.Byte");
$htmlBytes = $Array->newInstance($Byte, $Array->getLength($file));
try {
    $dis = new Java("java.io.DataInputStream", new Java("java.io.FileInputStream", $file));
    $dis->readFully($htmlBytes);
} finally {
    if (!java_is_null($dis)) $dis->close();
}

6. Java 方法 Files.write

Files->write(new File($path)->toPath(), $fontData, StandardOpenOption::CREATE); - 無法運作

workaround

$fstr = new Java("java.io.FileOutputStream", $path);
$Array = new java_class("java.lang.reflect.Array");
try {
    $fstr->write($fontData, 0, $Array->getLength($fontData));
} finally {
	$fstr->close();
}