How to migrate Intelligent Media Management document preview to the new version

Java

This requires Java SDK 3.17.4 or later. For installation information, see Installation.

package com.aliyun.oss.demo;
import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.GeneratePresignedUrlRequest;
import java.net.URL;
import java.util.Date;
public class Demo {
    public static void main(String[] args) throws Throwable {
        // Specify your custom domain name, for example, http://static.example.com.
        String endpoint = "http://static.example.com";
        // Obtain access credentials from environment variables. Before running this sample code, ensure the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // Specify the bucket name, for example, examplebucket.
        String bucketName = "examplebucket";
        // Specify the full path of the object. If the object is not in the root directory of the bucket, include the full path, such as exampledir/exampleobject.png.
        String objectName = "exampledir/exampleobject.png";
        // Specify the region where the bucket is located. For China (Hangzhou), set the region to cn-hangzhou.
        String region = "cn-hangzhou";
        // Create an OSSClient instance.
        // When the OSSClient instance is no longer needed, call the shutdown method to release resources.
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        // Set this parameter to true to enable CNAME.
        clientBuilderConfiguration.setSupportCname(true);
        // Explicitly declare the use of Signature V4.
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();
        try {
            // Specify document processing parameters.
            String style = "doc/preview,export_1,print_1/watermark,text_SW50ZXJuYWwgTWF0ZXJpYWxz,size_30,t_60";
            // Set the expiration time of the presigned URL to 3,600 seconds.
            Date expiration = new Date(new Date().getTime() + 3600 * 1000);
            GeneratePresignedUrlRequest req = new GeneratePresignedUrlRequest(bucketName, objectName, HttpMethod.GET);
            req.setExpiration(expiration);
            req.setProcess(style);
            URL signedUrl = ossClient.generatePresignedUrl(req);
            System.out.println(signedUrl);
        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught a ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

Python

This requires Python SDK 2.18.4 or later. For installation information, see Installation (Python SDK V1).

# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
# Obtain access credentials from environment variables. Before running this sample code, ensure the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
auth = oss2.ProviderAuthV4(EnvironmentVariableCredentialsProvider())
# Specify the bucket name.
bucket_name = 'examplebucket'
# Specify your custom domain name, for example, https://static.example.com.
endpoint = 'https://static.example.com'
# Specify the Alibaba Cloud region ID.
region = 'cn-hangzhou'
# Initialize the bucket with a custom domain name. If you use the default domain name, use bucket = oss2.Bucket(auth, endpoint, bucket_name, region=region).
bucket = oss2.Bucket(auth, endpoint, bucket_name, is_cname=True, region=region)
# Specify the object to process.
key = 'example.docx'
# Specify the expiration time in seconds.
expire_time = 3600
# Construct the processing instruction for online preview.
image_process = 'doc/preview,export_1,print_1/watermark,text_SW50ZXJuYWwgTWF0ZXJpYWxz,size_30,t_60'
# Generate a presigned URL with processing parameters.
url = bucket.sign_url('GET', key, expire_time, params={'x-oss-process': image_process}, slash_safe=True)
# Print the presigned URL.
print(url)

Go

This requires Go SDK 3.0.2 or later. For installation information, see Install OSS Go SDK.

package main
import (
	"context"
	"flag"
	"log"
	"time"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)
// Define global variables.
var (
	region     string // Storage region
	bucketName string // Bucket name
	objectName string // Object name
)
// The init function is used to initialize command-line parameters.
func init() {
	flag.StringVar(&region, "region", "", "The region in which the bucket is located.")
	flag.StringVar(&bucketName, "bucket", "", "The name of the bucket.")
	flag.StringVar(&objectName, "object", "", "The name of the object.")
}
func main() {
	// Parse command-line parameters.
	flag.Parse()
	// Check if the bucket name is empty.
	if len(bucketName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, bucket name required")
	}
	// Check if the region is empty.
	if len(region) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, region required")
	}
	// Check if the object name is empty.
	if len(objectName) == 0 {
		flag.PrintDefaults()
		log.Fatalf("invalid parameters, object name required")
	}
	// Load the default configuration and set the credential provider and region.
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(credentials.NewEnvironmentVariableCredentialsProvider()).
		WithRegion(region).
        // Specify your custom domain name, for example, http://static.example.com.
		WithEndpoint("http://static.example.com").
		WithUseCName(true)
	// Create an OSS client.
	client := oss.NewClient(cfg)
	// Generate a presigned URL for GetObject.
	result, err := client.Presign(context.TODO(), &oss.GetObjectRequest{
		Bucket:  oss.Ptr(bucketName),
		Key:     oss.Ptr(objectName),
        // Set the document processing parameters.
		Process: oss.Ptr("doc/preview,export_1,print_1/watermark,text_SW50ZXJuYWwgTWF0ZXJpYWxz,size_30,t_60"), 
	}, oss.PresignExpires(10*time.Minute))
	if err != nil {
		log.Fatalf("failed to get object presign %v", err)
	}
	log.Printf("request method:%v\n", result.Method)
	log.Printf("request expiration:%v\n", result.Expiration)
	log.Printf("request url:%v\n", result.URL)
	if len(result.SignedHeaders) > 0 {
		// If the result includes signed headers, you must include them in your GET request to avoid signature errors.
		log.Printf("signed headers:\n")
		for k, v := range result.SignedHeaders {
			log.Printf("%v: %v\n", k, v)
		}
	}
}

Node.js

This requires Node.js SDK 8.0 or later. For installation information, see Installation (Node.js SDK).

const OSS = require("ali-oss");
// Define a function to generate a presigned URL.
async function generateSignatureUrl(fileName) {
  // Get the presigned URL.
  const client = new OSS({
    // Specify your custom domain name, for example, http://static.example.com.
    endpoint: 'http://static.example.com',
    // Obtain access credentials from environment variables. Before running this sample code, ensure the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
    accessKeyId: process.env.OSS_ACCESS_KEY_ID,
    accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
    bucket: 'examplebucket',
    // Specify the region where the bucket is located. For China (Hangzhou), set the region to oss-cn-hangzhou.
    region: 'oss-cn-hangzhou',
    authorizationV4: true,
    cname: true
  });
  // Generate a presigned URL that includes document processing parameters.
  return await client.signatureUrlV4('GET', 3600, {
    headers: {}, // Set the request headers based on the actual request to be sent.
    queries: {
      "x-oss-process": "doc/preview,export_1,print_1/watermark,text_SW50ZXJuYWwgTWF0ZXJpYWxz,size_30,t_60" // Add document processing parameters.
    }
  }, fileName);
}
// Call the function and pass the file name.
generateSignatureUrl('yourFileName').then(url => {
  console.log('Generated Presigned URL:', url);
}).catch(err => {
  console.error('Error generating presigned URL:', err);
});

PHP

This requires PHP SDK 2.7.0 or later. For installation information, see Installation (PHP SDK V1).

<?php
if (is_file(__DIR__ . '/../autoload.php')) {
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}
use OSS\OssClient;
use OSS\Core\OssException;
use OSS\Http\RequestCore;
use OSS\Http\ResponseCore;
use OSS\Credentials\EnvironmentVariableCredentialsProvider;
// Obtain access credentials from environment variables. Before running this sample code, ensure the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are set.
$provider = new EnvironmentVariableCredentialsProvider();
//Specify your custom domain name, for example, http://static.example.com.
$endpoint = "http://static.example.com";
// Specify the bucket name, for example, examplebucket.
$bucket= "examplebucket";
// If the document is in the root directory of the bucket, specify the document name. If not, include the full path, such as exampledir/example.docx.
$object = 'example.docx'; 
$config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        "cname"	=> true,
        "region"=> "cn-hangzhou"
    );
$ossClient = new OssClient($config);
// Generate a presigned URL with document processing parameters that is valid for 3,600 seconds. You can access this URL directly in a browser.
$timeout = 3600;
$options = array(
    // Construct the processing instruction for online preview.
    OssClient::OSS_PROCESS => "doc/preview,export_1,print_1/watermark,text_SW50ZXJuYWwgTWF0ZXJpYWxz,size_30,t_60");
$signedUrl = $ossClient->signUrl($bucket, $object, $timeout, "GET", $options);
print("Presigned URL: \n" . $signedUrl);