Add JavaIO and CSV example (#234)

* [javakit] Generate some java.io types

* [javakit] exception description should include type, otherwise hard to
act on

* [sample] extend dependency example to consume commons csv as an example

* add missing license in empty file

* [javakit] correct the description/toString of Throwable

* Discard changes to Samples/JavaKitSampleApp/Sources/JavaKitExample/com/example/swift/HelloSwift.java

* Discard changes to Samples/JavaKitSampleApp/Sources/JavaKitExample/JavaKitExample.swift

Author: ktoso

Package.swift

@@ -76,6 +76,11 @@ let package = Package(
       targets: ["JavaKitNetwork"]
     ),
 
+    .library(
+      name: "JavaKitIO",
+      targets: ["JavaKitIO"]
+    ),
+
     .library(
       name: "JavaKitReflection",
       targets: ["JavaKitReflection"]
@@ -241,6 +246,15 @@ let package = Package(
         .unsafeFlags(["-I\(javaIncludePath)", "-I\(javaPlatformIncludePath)"])
       ]
     ),
+    .target(
+      name: "JavaKitIO",
+      dependencies: ["JavaKit", "JavaKitCollection"],
+      exclude: ["swift-java.config"],
+      swiftSettings: [
+        .swiftLanguageMode(.v5),
+        .unsafeFlags(["-I\(javaIncludePath)", "-I\(javaPlatformIncludePath)"])
+      ]
+    ),
     .target(
       name: "JavaKitReflection",
       dependencies: ["JavaKit", "JavaKitCollection"],
@@ -448,6 +462,6 @@ let package = Package(
       swiftSettings: [
         .swiftLanguageMode(.v5)
       ]
-    )
+    ),
   ]
 )

Samples/JavaDependencySampleApp/Package.swift

@@ -86,6 +86,8 @@ let package = Package(
         .product(name: "JavaKit", package: "swift-java"),
         .product(name: "JavaKitFunction", package: "swift-java"),
         .product(name: "JavaKitCollection", package: "swift-java"),
+        .product(name: "JavaKitIO", package: "swift-java"),
+        .product(name: "JavaKitNetwork", package: "swift-java"),
       ],
       exclude: ["swift-java.config"],
       swiftSettings: [
@@ -98,5 +100,7 @@ let package = Package(
       ]
     ),
 
+    .target(name: "JavaExample"),
+
   ]
 )

Samples/JavaDependencySampleApp/Sources/JavaCommonsCSV/swift-java.config

@@ -1,7 +1,10 @@
 {
   "classes" : {
     "org.apache.commons.io.FilenameUtils" : "FilenameUtils",
-    "org.apache.commons.io.IOCase" : "IOCase"
+    "org.apache.commons.io.IOCase" : "IOCase",
+    "org.apache.commons.csv.CSVFormat" : "CSVFormat",
+    "org.apache.commons.csv.CSVParser" : "CSVParser",
+    "org.apache.commons.csv.CSVRecord" : "CSVRecord"
   },
   "dependencies" : [
     "org.apache.commons:commons-csv:1.12.0"

Samples/JavaDependencySampleApp/Sources/JavaDependencySample/main.swift

@@ -14,6 +14,7 @@
 
 import JavaKit
 import JavaKitFunction
+import JavaKitIO
 import JavaKitConfigurationShared
 import Foundation
 
@@ -42,4 +43,13 @@ let ext = try! FilenameUtilsClass.getExtension(path)
 print("org.apache.commons.io.FilenameUtils.getExtension = \(ext)")
 precondition(ext == "exe")
 
+let CSVFormatClass = try JavaClass<CSVFormat>()
+
+let reader = StringReader("hello,example")
+for record in try CSVFormatClass.RFC4180.parse(reader)!.getRecords()! {
+  for field in record.toList()! {
+    print("Field: \(field)")
+  }
+}
+
 print("Done.")

Samples/JavaDependencySampleApp/Sources/JavaExample/JavaExample.swift

@@ -0,0 +1,13 @@
+//===----------------------------------------------------------------------===//
+//
+// This source file is part of the Swift.org open source project
+//
+// Copyright (c) YEARS Apple Inc. and the Swift.org project authors
+// Licensed under Apache License v2.0
+//
+// See LICENSE.txt for license information
+// See CONTRIBUTORS.txt for the list of Swift.org project authors
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+//===----------------------------------------------------------------------===//

Sources/Java2Swift/JavaToSwift+FetchDependencies.swift

@@ -40,6 +40,10 @@ extension JavaToSwift {
     print("[info][swift-java] Resolved classpath for \(deps.count) dependencies of '\(moduleName)', classpath entries: \(classpathEntries.count), ", terminator: "")
     print("done.".green)
 
+    for entry in classpathEntries {
+      print("[info][swift-java] Classpath entry: \(entry)")
+    }
+
     return ResolvedDependencyClasspath(for: dependencies, classpath: dependenciesClasspath)
   }
 
@@ -133,6 +137,8 @@ extension JavaToSwift {
     // The file contents are just plain
     let contents = resolvedClasspath.classpath
 
+      print("[debug][swift-java] Resolved dependency: \(classpath)")
+
     // Write the file
     try writeContents(
       contents,

Sources/JavaKit/Exceptions/Throwable+Error.swift

@@ -15,7 +15,7 @@
 // Translate all Java Throwable instances in a Swift error.
 extension Throwable: Error, CustomStringConvertible {
   public var description: String {
-    return getMessage()
+    return toString()
   }
 }
 

Sources/JavaKit/generated/Appendable.swift

@@ -0,0 +1,14 @@
+// Auto-generated by Java-to-Swift wrapper generator.
+import JavaRuntime
+
+@JavaInterface("java.lang.Appendable")
+public struct Appendable {
+  @JavaMethod
+  public func append(_ arg0: CharSequence?) throws -> Appendable!
+
+  @JavaMethod
+  public func append(_ arg0: CharSequence?, _ arg1: Int32, _ arg2: Int32) throws -> Appendable!
+
+  @JavaMethod
+  public func append(_ arg0: UInt16) throws -> Appendable!
+}

Sources/JavaKit/generated/CharSequence.swift

@@ -0,0 +1,24 @@
+// Auto-generated by Java-to-Swift wrapper generator.
+import JavaRuntime
+
+@JavaInterface("java.lang.CharSequence")
+public struct CharSequence {
+  @JavaMethod
+  public func length() -> Int32
+
+  @JavaMethod
+  public func toString() -> String
+
+  @JavaMethod
+  public func charAt(_ arg0: Int32) -> UInt16
+
+  @JavaMethod
+  public func isEmpty() -> Bool
+
+  @JavaMethod
+  public func subSequence(_ arg0: Int32, _ arg1: Int32) -> CharSequence!
+}
+extension JavaClass<CharSequence> {
+  @JavaStaticMethod
+  public func compare(_ arg0: CharSequence?, _ arg1: CharSequence?) -> Int32
+}

Sources/JavaKit/generated/JavaInteger.swift

@@ -3,6 +3,7 @@ import JavaRuntime
 
 @JavaClass("java.lang.Integer")
 open class JavaInteger: JavaNumber {
+
   @JavaMethod
   @_nonoverride public convenience init(_ arg0: Int32, environment: JNIEnvironment? = nil)