Log
Updated at：2025-10-20
The BCC Java SDK package uses logback as its default SLF4J implementation. If users don't have their own implementation, they can use logback directly. Alternatively, they can opt for other implementations such as log4j.
Default logging
To utilize the default logback, include a logback.xml configuration file in the classpath. If this file is missing, the log level defaults to DEBUG.
Java
1<configuration>
2 <property name="LOG_HOME" value="./log/"/>
3 <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
4 <!-- encoders are assigned the type
5 ch.qos.logback.classic.encoder.PatternLayoutEncoder by default -->
6 <encoder>
7 <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
8 </encoder>
9 </appender>
10 <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
11 <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
12 <FileNamePattern>${LOG_HOME}/BccUnitTest.%d{yyyy-MM-dd}.log</FileNamePattern>
13 <MaxHistory>30</MaxHistory>
14 </rollingPolicy>
15 <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
16 <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern>
17 </encoder>
18 <triggeringPolicy class="ch.qos.logback.core.rolling.SizeBasedTriggeringPolicy">
19 <MaxFileSize>10MB</MaxFileSize>
20 </triggeringPolicy>
21 </appender>
22 <root level="info">
23 <appender-ref ref="STDOUT"/>
24 <appender-ref ref="FILE"/>
25 </root>
26</configuration>Custom logging modules
For projects that already use a specific logging implementation, logback can be excluded via Maven (pom.xml).
Java
1<?xml version="1.0" encoding="utf-8"?>
2<dependency>
3 <groupId>com.baidubce</groupId>
4 <artifactId>bce-java-sdk</artifactId>
5 <version>${bce.sdk.version}</version>
6 <exclusions>
7 <exclusion>
8 <groupId>ch.qos.logback</groupId>
9 <artifactId>logback-classic</artifactId>
10 </exclusion>
11 <exclusion>
12 <groupId>ch.qos.logback</groupId>
13 <artifactId>logback-core</artifactId>
14 </exclusion>
15 <exclusion>
16 <groupId>org.slf4j</groupId>
17 <artifactId>jcl-over-slf4j</artifactId>
18 </exclusion>
19 </exclusions>
20</dependency>