diff --git a/src/site/ko/xdoc/java-api.xml b/src/site/ko/xdoc/java-api.xml
index 57da7080a60..65cdae33ff6 100644
--- a/src/site/ko/xdoc/java-api.xml
+++ b/src/site/ko/xdoc/java-api.xml
@@ -270,7 +270,7 @@ int insert(String statement)
 int update(String statement)
 int delete(String statement)]]></source>
 
-  <p>A Cursor offers the same results as a List, except it fetches data lazily using an Iterator.</p>
+  <p>Cursor는 List와 동일한 결과를 보여주지만, 데이터를 반복문을 통해 lazy하게 가져온다</p>
   <source><![CDATA[try (Cursor<MyEntity> entities = session.selectCursor(statement, param)) {
    for (MyEntity entity:entities) {
       // process one entity
@@ -751,36 +751,37 @@ class UserSqlBuilder {
   }
 }]]></source>
 
-    <p>This example shows usage that share an sql provider class to all mapper methods using global configuration(Available since 3.5.6):</p>
+    <p>이 예제는 모든 매퍼 메소드에 SQL 프로바이더 클래스를 전역 설정으로 공유하는 방법을 보여준다. (3.5.6 버전부터 사용 가능):</p>
     <source><![CDATA[
 Configuration configuration = new Configuration();
 configuration.setDefaultSqlProviderType(TemplateFilePathProvider.class); // Specify an sql provider class for sharing on all mapper methods
 // ...]]></source>
     <source><![CDATA[
-// Can omit the type/value attribute on sql provider annotation
-// If omit it, the MyBatis apply the class that specified on defaultSqlProviderType.
+// sql provider 애노테이션에서 type/value 속성을 생략할 수 있다.
+// 생략시, MyBatis는 defaultSqlProviderType으로 지정된 클래스를 적용한다.
 public interface UserMapper {
 
-  @SelectProvider // Same with @SelectProvider(TemplateFilePathProvider.class)
+  @SelectProvider // @SelectProvider(TemplateFilePathProvider.class) 와 동일하다
   User findUser(int id);
 
-  @InsertProvider // Same with @InsertProvider(TemplateFilePathProvider.class)
+  @InsertProvider // @InsertProvider(TemplateFilePathProvider.class) 와 동일하다
   void createUser(User user);
 
-  @UpdateProvider // Same with @UpdateProvider(TemplateFilePathProvider.class)
+  @UpdateProvider // @UpdateProvider(TemplateFilePathProvider.class) 와 동일하다
   void updateUser(User user);
 
-  @DeleteProvider // Same with @DeleteProvider(TemplateFilePathProvider.class)
+  @DeleteProvider // @DeleteProvider(TemplateFilePathProvider.class) 와 동일하다
   void deleteUser(int id);
 }]]></source>
 
-    <p>This example shows usage the default implementation of <code>ProviderMethodResolver</code>(available since MyBatis 3.5.1 or later):</p>
+    <p>이 예제는 <code>ProviderMethodResolver</code>의 기본 구현 사용법을 보여준다.(available since MyBatis 3.5.1 or later):</p>
     <source><![CDATA[@SelectProvider(UserSqlProvider.class)
 List<User> getUsersByName(String name);
 
-// Implements the ProviderMethodResolver on your provider class
+// provider 클래스에서 ProviderMethodResolver 를 구현
 class UserSqlProvider implements ProviderMethodResolver {
   // In default implementation, it will resolve a method that method name is matched with mapper method
+  // 기본 구현에서, 메소드 이름이 mapper 메소드와 일치하는 경우 해당 메소드를 찾는다.
   public static String getUsersByName(final String name) {
     return new SQL(){{
       SELECT("*");
@@ -793,11 +794,11 @@ class UserSqlProvider implements ProviderMethodResolver {
   }
 }]]></source>
 
-    <p>This example shows usage the <code>databaseId</code> attribute on the statement annotation(Available since 3.5.5):</p>
+    <p>이 예제는 statement 애노테이션에서 <code>databaseId</code>  속성이 어떻게 활용되는지를 보여줍니다(3.5.5 버전부터 사용 가능):</p>
     <source><![CDATA[
-@Select(value = "SELECT SYS_GUID() FROM dual", databaseId = "oracle") // Use this statement if DatabaseIdProvider provide "oracle"
-@Select(value = "SELECT uuid_generate_v4()", databaseId = "postgres") // Use this statement if DatabaseIdProvider provide "postgres"
-@Select("SELECT RANDOM_UUID()") // Use this statement if the DatabaseIdProvider not configured or not matches databaseId
+@Select(value = "SELECT SYS_GUID() FROM dual", databaseId = "oracle") // DatabaseIdProvider가 "oracle"을 제공하면 이 구문을 사용
+@Select(value = "SELECT uuid_generate_v4()", databaseId = "postgres") // DatabaseIdProvider가 "postgres"를 제공하면 이 구문을 사용
+@Select("SELECT RANDOM_UUID()") // DatabaseIdProvider가 설정되지 않았거나 일치하는 databaseId가 없는 경우 이 구문을 사용
 String generateId();
 ]]></source>