Skip to main content

openapi_nexus/generators/java/okhttp/
codegen.rs

1use std::error::Error;
2
3use heck::ToKebabCase as _;
4
5use super::config::JavaOkhttpConfig;
6use super::runtime::runtime_files;
7use super::{sigil_emit, sigil_emit_api};
8use crate::codegen::traits::code_generator::CodeGenerator;
9use crate::codegen::traits::file_writer::{FileInfo, FileWriter};
10use crate::codegen::{GeneratorType, Language};
11use crate::generators::request_inputs::plan_multipart_request_inputs;
12use crate::ir::types::{IrInfo, IrSpec};
13
14const DEFAULT_PACKAGE: &str = "com.example.sdk";
15
16#[derive(Debug, Clone)]
17pub struct JavaOkhttpCodeGenerator {
18    config: JavaOkhttpConfig,
19}
20
21impl JavaOkhttpCodeGenerator {
22    pub fn new(config: toml::value::Table) -> Self {
23        Self {
24            config: JavaOkhttpConfig::from(config),
25        }
26    }
27
28    fn package_name(&self) -> String {
29        self.config
30            .package_name
31            .clone()
32            .unwrap_or_else(|| DEFAULT_PACKAGE.to_string())
33    }
34
35    fn generate_ir(&self, ir: &IrSpec) -> Result<Vec<FileInfo>, Box<dyn Error + Send + Sync>> {
36        let package_name = self.package_name();
37        let header = render_file_header(&ir.info);
38        let request_inputs = plan_multipart_request_inputs(ir);
39
40        let mut files = Vec::new();
41
42        files.extend(
43            sigil_emit::generate_model_files(ir, &package_name, &header, &request_inputs).map_err(
44                |msg| Box::<dyn Error + Send + Sync>::from(format!("sigil_emit models: {msg}")),
45            )?,
46        );
47
48        files.extend(
49            sigil_emit_api::generate_api_files(ir, &package_name, &header, &request_inputs)
50                .map_err(|msg| {
51                    Box::<dyn Error + Send + Sync>::from(format!("sigil_emit_api: {msg}"))
52                })?,
53        );
54
55        files.extend(runtime_files(
56            &header,
57            &package_name,
58            request_inputs.has_uploads(),
59        ));
60
61        files.push(build_gradle_file(&package_name, &ir.info));
62        files.push(readme_file(&ir.info));
63
64        Ok(files)
65    }
66}
67
68impl CodeGenerator for JavaOkhttpCodeGenerator {
69    fn language(&self) -> Language {
70        Language::Java
71    }
72
73    fn generator_type(&self) -> GeneratorType {
74        GeneratorType::JavaOkhttp
75    }
76
77    fn generate(&self, ir: &IrSpec) -> Result<Vec<FileInfo>, Box<dyn Error + Send + Sync>> {
78        self.generate_ir(ir)
79    }
80}
81
82impl FileWriter for JavaOkhttpCodeGenerator {}
83
84fn render_file_header(info: &IrInfo) -> String {
85    let mut out = String::new();
86    out.push_str("// Code generated by openapi-nexus. DO NOT EDIT.\n");
87    out.push_str("//\n");
88    out.push_str(&format!("// {} — {}\n", info.title, info.version));
89    if let Some(desc) = &info.description {
90        for line in desc.lines() {
91            if line.is_empty() {
92                out.push_str("//\n");
93            } else {
94                out.push_str(&format!("// {line}\n"));
95            }
96        }
97    }
98    out.push('\n');
99    out
100}
101
102fn build_gradle_file(package_name: &str, info: &IrInfo) -> FileInfo {
103    let content = format!(
104        r#"plugins {{
105    id("java-library")
106}}
107
108group = "{package_name}"
109version = "{version}"
110
111repositories {{
112    mavenCentral()
113}}
114
115dependencies {{
116    implementation("com.squareup.okhttp3:okhttp:4.12.0")
117    implementation("com.google.code.gson:gson:2.11.0")
118}}
119
120java {{
121    toolchain {{
122        languageVersion.set(JavaLanguageVersion.of(17))
123    }}
124}}
125
126sourceSets {{
127    main {{
128        java {{
129            srcDirs("apis", "models", "runtime")
130        }}
131    }}
132}}
133"#,
134        version = info.version,
135    );
136    FileInfo::project("build.gradle".to_string(), content)
137}
138
139fn readme_file(info: &IrInfo) -> FileInfo {
140    let title = &info.title;
141    let version = &info.version;
142    let description = info
143        .description
144        .clone()
145        .unwrap_or_else(|| "Generated Java SDK.".to_string());
146    let package = info.title.to_kebab_case();
147    let content = format!(
148        "# {title}\n\n{description}\n\nVersion: `{version}`\n\nGenerated by [openapi-nexus](https://github.com/rust-codegen-group/openapi-nexus) for `{package}`.\n"
149    );
150    FileInfo::readme("README.md".to_string(), content)
151}