Deprecate sponge schematic reader/writer and tell users why (#1287)

This commit is contained in:
dordsor21 2021-09-12 15:57:52 +01:00 committed by NotMyFault
parent 8e214b1232
commit 5d31b7034d
No known key found for this signature in database
GPG Key ID: 158F5701A6AAD00C
4 changed files with 19 additions and 3 deletions

View File

@ -177,7 +177,7 @@ public class FaweDelegateSchematicHandler {
public void run(OutputStream output) {
if (weTag instanceof CompressedSchematicTag) {
Clipboard clipboard = ((CompressedSchematicTag) weTag).getSource();
BuiltInClipboardFormat.SPONGE_SCHEMATIC.write(output, clipboard);
BuiltInClipboardFormat.FAST.write(output, clipboard);
}
try {
try (ParallelGZIPOutputStream gzip = new ParallelGZIPOutputStream(output)) {

View File

@ -51,7 +51,7 @@ import java.util.zip.GZIPOutputStream;
public enum BuiltInClipboardFormat implements ClipboardFormat {
//FAWE start - register fast clipboard io
FAST("fast", "fawe") {
FAST("fast", "fawe", "sponge", "schem") {
@Override
public String getPrimaryFileExtension() {
return "schem";
@ -119,7 +119,13 @@ public enum BuiltInClipboardFormat implements ClipboardFormat {
}
},
SPONGE_SCHEMATIC("sponge", "schem") {
/**
* @deprecated Slow, resource intensive, but sometimes safer than using the recommended
* {@link BuiltInClipboardFormat#FAST}.
* Avoid using with any large schematics/clipboards for reading/writing.
*/
@Deprecated
SPONGE_SCHEMATIC("slow", "safe") {
@Override
public String getPrimaryFileExtension() {
return "schem";

View File

@ -68,7 +68,12 @@ import static com.google.common.base.Preconditions.checkNotNull;
/**
* Reads schematic files using the Sponge Schematic Specification.
*
* @deprecated Slow, resource intensive, but sometimes safer than using the recommended
* {@link com.fastasyncworldedit.core.extent.clipboard.io.FastSchematicReader}.
* Avoid reading large schematics with this reader.
*/
@Deprecated
public class SpongeSchematicReader extends NBTSchematicReader {
private static final Logger LOGGER = LogManagerCompat.getLogger();

View File

@ -53,7 +53,12 @@ import static com.google.common.base.Preconditions.checkNotNull;
/**
* Writes schematic files using the Sponge schematic format.
*
* @deprecated Slow, resource intensive, but sometimes safer than using the recommended
* {@link com.fastasyncworldedit.core.extent.clipboard.io.FastSchematicWriter}.
* Avoid using large clipboards to create schematics with this writer.
*/
@Deprecated
public class SpongeSchematicWriter implements ClipboardWriter {
private static final int CURRENT_VERSION = 2;